Method: customers.accountLinks.mutate

建立或移除帳戶連結。從 V5 開始，系統不支援透過 AccountLinkService.MutateAccountLink 建立連結。請改用 AccountLinkService.CreateAccountLink。

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

HTTP 要求

POST https://googleads.googleapis.com/v19/customers/{customerId}/accountLinks:mutate

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

路徑參數

參數
customerId

string

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

要求主體

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

JSON 表示法 
{
  "operation": {
    object (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
欄位
operation

object (AccountLinkOperation)

必要欄位。要對連結執行的作業。
partialFailure

boolean

如果為 true，系統會執行成功的作業，並傳回無效作業的錯誤。如果設為 false，只有在所有作業都有效時，系統才會在單一交易中執行所有作業。預設值為 false。
validateOnly

boolean

如果為 true，系統會驗證要求，但不會執行。系統只會傳回錯誤，不會傳回結果。

回應主體

帳戶連結變更的回應訊息。

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

JSON 表示法 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
欄位
result

object (MutateAccountLinkResult)

變異結果。
partialFailureError

object (Status)

在部分失敗模式中，與作業失敗相關的錯誤。只有在 partialFailure = true 且所有錯誤都發生在作業中時，系統才會傳回此值。如果在作業之外發生任何錯誤 (例如驗證錯誤)，我們會傳回 RPC 層級錯誤。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 Overview。

AccountLinkOperation

帳戶連結的單一更新。

JSON 表示法 
{
  "updateMask": string,

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

string (FieldMask format)

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

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

object (AccountLink)

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

string

移除作業：預期會傳回要移除的帳戶連結資源名稱，格式如下：

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

帳戶連結的結果會發生變化。

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

string

在成功執行作業時傳回。