Method: customers.customerUserAccesses.mutate

更新、移除特定客戶的使用者權限。系統會傳回作業狀態。

擲回錯誤清單：AuthenticationError AuthorizationError CustomerUserAccessError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

必要欄位。要修改的客戶 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "operation": {
    object (CustomerUserAccessOperation)
  }
}
欄位
operation

object (CustomerUserAccessOperation)

必要欄位。要對客戶執行的作業

回應主體

客戶使用者存取權異動的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "result": {
    object (MutateCustomerUserAccessResult)
  }
}
欄位
result

object (MutateCustomerUserAccessResult)

mut 的結果。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

CustomerUserAccessOperation

對客戶使用者存取權執行一次操作 (更新、移除)。

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

如果作業成功，系統會傳回。