Method: labels.permissions.batchUpdate
ラベルの権限を更新します。指定されたプリンシパルの権限が存在しない場合は、新しいラベル権限が作成されます。それ以外の場合は、既存の権限が更新されます。権限はラベルリソース全体に影響します。改訂されるものではなく、公開する必要はありません。
HTTP リクエスト
POST https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions:batchUpdate
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
parent |
string
必須。更新するすべての権限で共有される親ラベルリソース名。形式: labels/{label} 設定する場合、UpdateLabelPermissionRequest メッセージの親フィールドは空にするか、このフィールドと一致する必要があります。
|
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
{
"requests": [
{
object (UpdateLabelPermissionRequest )
}
],
"useAdminAccess": boolean
} |
フィールド |
requests[] |
object (UpdateLabelPermissionRequest )
必須。更新するリソースを指定するリクエスト メッセージ。
|
useAdminAccess |
boolean
ユーザーの管理者認証情報を使用するには、true に設定します。サーバーは、アクセスを許可する前に、ユーザーがラベルの管理者であることを確認します。これが設定されている場合、UpdateLabelPermissionRequest メッセージの useAdminAccess フィールドは空にされるか、このフィールドと一致する必要があります。
|
レスポンスの本文
成功した場合、レスポンスの本文には BatchUpdateLabelPermissionsResponse
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
詳細については、承認ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-10-11 UTC。
[null,null,["最終更新日 2024-10-11 UTC。"],[[["Updates permissions for a Label, creating new ones if they don't exist and updating existing ones otherwise."],["Permissions apply to the entire Label resource, are not versioned, and don't need publishing."],["The request body should contain an array of `UpdateLabelPermissionRequest` objects and a `useAdminAccess` boolean."],["Requires authorization with either `https://www.googleapis.com/auth/drive.labels` or `https://www.googleapis.com/auth/drive.admin.labels` scopes."],["Successful responses return a `BatchUpdateLabelPermissionsResponse` object."]]],["This content describes updating Label permissions via a `POST` request to `https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions:batchUpdate`. The `parent` path parameter specifies the Label resource. The request body, in JSON format, includes an array of `UpdateLabelPermissionRequest` objects in `requests` and `useAdminAccess` field that allows using the admin credentials. The response is a `BatchUpdateLabelPermissionsResponse`. This action requires specific OAuth scopes: `drive.labels` or `drive.admin.labels`.\n"]]