ドキュメント本文へスキップ
API

ファイルへのすべてのリンクを取り消す

ファイルを非公開にする。送信済みのメール内のものも含め、そのファイルへの公開リンクはすべて無効になる。

DELETE/files/{id}/links

実際の呼び出しをワークスペースに対して実行します。

DELETE /files/{id}/links

ファイルを非公開にする。送信済みのメール内のものも含め、そのファイルへの公開リンクはすべて無効になる。

例

files:write が必要。「ファイル」ページの「非公開にする」と同じ操作である。revoked は、まだ有効で今回無効になったリンクの数を示す。

curl
curl -X DELETE "$OE/files/file_6bb640f5b99e47deb758f1f5/links" -H "$AUTH"
レスポンス
{  "object": "file_link_revocation",  "fileId": "file_6bb640f5b99e47deb758f1f5",  "revoked": 2}

有効なリンクがないファイルは revoked: 0 を返すので、呼び出しは何度繰り返しても安全である。ファイル自体は残り、POST /files/{id}/links で新しいリンクとして再び公開できる。

特定のアドレスに限定されたキーが届くのは、そこに届いたファイルだけで、それ以外のファイルは 404 になる。

リファレンス