建立或移除帳戶連結。V5 版本不支援透過 AccountLinkService.MutateAccountLink 建立。請改用 AccountLinkService.CreateAccountLink。
擲回錯誤清單:AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v16/customers/{customerId}/accountLinks:mutate
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
必要欄位。要修改的客戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"operation": {
object ( |
欄位 | |
---|---|
operation |
必要欄位。對連結執行的作業。 |
partialFailure |
若為 true,將會執行成功的作業,而且無效的作業也會傳回錯誤。如為 false,則只有在所有作業都有效時,才會在一筆交易中執行所有作業。預設值為 false。 |
validateOnly |
如果為 true,表示要求會完成驗證,但尚未執行。系統只會傳回錯誤,不會傳回結果。 |
回應主體
帳戶連結 change 的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "result": { object ( |
欄位 | |
---|---|
result |
mut 的結果。 |
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 |
如果作業成功,系統會傳回。 |