Method: customers.customerManagerLinks.mutate

更新客戶管理員連結。系統會傳回作業狀態。

擲回錯誤清單：AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError QuotaError RequestError

HTTP 要求

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

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

路徑參數

參數
customerId

string

必要欄位。要修改客戶管理員連結的客戶 ID。

要求主體

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

JSON 表示法 
{
  "operations": [
    {
      object (CustomerManagerLinkOperation)
    }
  ],
  "validateOnly": boolean
}
欄位
operations[]

object (CustomerManagerLinkOperation)

必要欄位。對個別客戶管理員連結執行的作業清單。
validateOnly

boolean

如果為 true，表示要求會完成驗證，但尚未執行。系統只會傳回錯誤，不會傳回結果。

回應主體

CustomerManagerLink 變更的回應訊息。

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

JSON 表示法 
{
  "results": [
    {
      object (MutateCustomerManagerLinkResult)
    }
  ]
}
欄位
results[]

object (MutateCustomerManagerLinkResult)

結果，用來識別受 修改要求影響的資源。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

CustomerManagerLinkOperation

更新 CustomerManagerLink 的狀態。可能的動作如下：1. 狀態為「ACTIVE」(啟用) 的更新作業，接受待處理的邀請。2. 狀態為 REFUSED 的更新作業拒絕待處理邀請。3. 狀態為「INACTIVE」的更新作業會終止與管理員的連結。

JSON 表示法 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (CustomerManagerLink)
  }
  // End of list of possible types for union field operation.
}
欄位
updateMask

string (FieldMask format)

FieldMask，用於決定更新中要修改哪些資源欄位。

此為以半形逗號分隔的完整欄位名稱清單，範例："user.displayName,photo"。
聯集欄位 operation。修改作業。operation 只能是下列其中一項：
update

object (CustomerManagerLink)

更新作業：連結應具備有效的資源名稱。

MutateCustomerManagerLinkResult

客戶管理員連結的結果有所變更。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

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