ファイルまたは共有ドライブの権限を作成します。
警告: 同じファイルに対する権限操作の同時実行はサポートされていません。最後の更新のみが適用されます。
HTTP リクエスト
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ | |
|---|---|
fileId |
ファイルまたは共有ドライブの ID。 |
クエリ パラメータ
| パラメータ | |
|---|---|
emailMessage |
通知メールに含める書式なしテキストのカスタム メッセージ。 |
enforceSingleParent |
非推奨: 詳しくは、 |
moveToNewOwnersRoot |
このパラメータは、アイテムが共有ドライブにない場合にのみ有効になり、リクエストでアイテムの所有権の譲渡を試みます。 |
sendNotificationEmail |
ユーザーまたはグループに共有するときに通知メールを送信するかどうか。ユーザーとグループのデフォルトは |
supportsAllDrives |
リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしているかどうか。 |
supportsTeamDrives |
非推奨: 代わりに、 |
transferOwnership |
指定したユーザーに所有権を譲渡し、現在の所有者を書き込み権限にダウングレードするかどうか。このパラメータは、副作用を確認するために必要です。 |
useDomainAdminAccess |
リクエストをドメイン管理者として発行します。true に設定すると、ファイル ID パラメータが共有ドライブを参照し、リクエスト元が共有ドライブが属するドメインの管理者である場合、リクエスト元にアクセス権が付与されます。 |
enforceExpansiveAccess |
リクエストで広範なアクセスルールを適用するかどうか。 |
リクエストの本文
リクエストの本文には Permission のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Permission のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.file
一部のスコープは制限されており、アプリでそれらを使用するにはセキュリティ評価が必要です。詳しくは、承認ガイドをご覧ください。