建立或移除帳戶連結。自 V5 版本起,無法透過 AccountLinkService.MutateAccountLink 建立。請改用 AccountLinkService.CreateAccountLink。
擲回錯誤清單:AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v14/customers/{customerId}/accountLinks:mutate
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
必要欄位。要修改的客戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"operation": {
object ( |
欄位 | |
---|---|
operation |
必要欄位。要對連結執行的作業。 |
partialFailure |
如果為 true,系統就會執行成功的作業,且無效的作業會傳回錯誤。如果為 false,只有在所有作業皆有效的情況下,系統才會在單筆交易中執行所有作業。預設值為 false。 |
validateOnly |
如果為 true,則驗證要求但尚未執行。系統只會傳回錯誤,而非傳回結果。 |
回應主體
帳戶連結修改的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "result": { object ( |
欄位 | |
---|---|
result |
修改結果。 |
partialFailureError |
在部分失敗模式下,與作業失敗相關的錯誤。只有在部分失敗 = true 且作業內發生所有錯誤時,才會傳回這個編號。如果在作業之外發生任何錯誤 (例如驗證錯誤),我們會傳回遠端程序呼叫 (RPC) 層級錯誤。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
AccountLinkOperation
單一帳戶連結更新。
JSON 表示法 |
---|
{ "updateMask": string, // Union field |
欄位 | |
---|---|
updateMask |
可決定更新中要修改哪些資源欄位的 FieldMask。 此為以半形逗號分隔的完整欄位名稱清單。範例: |
聯集欄位 operation 。要執行的作業。operation 只能是下列其中一項: |
|
update |
更新作業:帳戶連結應包含有效的資源名稱。 |
remove |
移除作業:要移除的帳戶連結資源名稱,格式如下:
|
MutateAccountLinkResult
帳戶連結產生的結果。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
傳回成功的作業。 |