Method: customers.customerUserAccesses.mutate

更新により、特定の顧客に対するユーザーの権限が削除されます。オペレーションのステータスが返されます。

スローされるエラーのリスト: AuthenticationError AuthorizationError CustomerUserAccessError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

HTTP リクエスト

POST https://googleads.googleapis.com/v16/customers/{customerId}/customerUserAccesses:mutate

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

必須。変更する顧客の ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "operation": {
    object (CustomerUserAccessOperation)
  }
}
フィールド
operation

object (CustomerUserAccessOperation)

必須。顧客に対して行う操作

レスポンスの本文

顧客ユーザーのアクセス権の変更に対するレスポンス メッセージ。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "result": {
    object (MutateCustomerUserAccessResult)
  }
}
フィールド
result

object (MutateCustomerUserAccessResult)

変換の結果。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/adwords

詳細については、OAuth 2.0 の概要をご覧ください。

CustomerUserAccessOperation

お客様のユーザー アクセスに対する 1 回のオペレーション（更新、削除）。

JSON 表現 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (CustomerUserAccess)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
フィールド
updateMask

string (FieldMask format)

更新で変更されるリソース フィールドを決定する FieldMask。

これは、フィールドの完全修飾名のカンマ区切りリストです。（例: "user.displayName,photo"）。
共用体フィールド operation。変換オペレーション。operation は次のいずれかになります。
update

object (CustomerUserAccess)

更新オペレーション: お客様のユーザー アクセスには有効なリソース名が必要です。
remove

string

削除オペレーション: 削除されたアクセス権のリソース名は次の形式である必要があります。

customers/{customerId}/customerUserAccesses/{CustomerUserAccess.user_id}

MutateCustomerUserAccessResult

顧客ユーザーのアクセス権の結果が変わります。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

オペレーションが正常に完了した場合に返されます。