Method: customers.audiences.mutate

建立目標對象。系統會傳回作業狀態。

擲回錯誤清單：AudienceError

HTTP 要求

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

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

路徑參數

參數
customerId

string

必要欄位。目標對象遭到修改的客戶 ID。

要求主體

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

JSON 表示法 
{
  "operations": [
    {
      object (AudienceOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
欄位
operations[]

object (AudienceOperation)

必要欄位。要對個別目標對象執行的作業清單。
partialFailure

boolean

若為 true，將會執行成功的作業，而且無效的作業也會傳回錯誤。如為 false，則只有在所有作業都有效時，才會在一筆交易中執行所有作業。預設值為 false。
validateOnly

boolean

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

enum (ResponseContentType)

回應內容類型設定。決定在修改後要傳回可變動資源還是僅傳回資源名稱。

回應主體

目標對象變更的回應訊息。

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

JSON 表示法 
{
  "results": [
    {
      object (MutateAudienceResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
欄位
results[]

object (MutateAudienceResult)

所有 的 變更結果。
partialFailureError

object (Status)

部分失敗模式下的作業失敗相關錯誤。只有在部分失敗 = true 且所有錯誤發生於作業內部時，才會傳回這個值。如果在作業之外發生任何錯誤 (例如驗證錯誤)，系統會傳回遠端程序呼叫 (RPC) 層級錯誤。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。