Method: customers.batchJobs.addOperations

將作業新增至批次工作。

擲回錯誤清單：AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

HTTP 要求

POST https://googleads.googleapis.com/v17/{resourceName=customers/*/batchJobs/*}:addOperations

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

路徑參數

參數
resourceName

string

必要欄位。批次工作的資源名稱。

要求主體

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

JSON 表示法 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
欄位
sequenceToken

string

用於強制執行排序的權杖。

批次工作的第一個 batchJob.addOperations 要求不得設定 serialToken。後續要求必須將 lastSequenceToken 值設為在上個 batchJobs.addOperations 回應中接收的 nextSequenceToken 值。
mutateOperations[]

object (MutateOperation)

必要欄位。列出要新增的變更清單。

作業可以使用負整數做為臨時 ID，代表此批次工作中建立的實體之間的依附元件。舉例來說，ID 為 1234 的客戶可以在第一個作業中建立廣告活動，並將資源名稱明確設為「customers/1234/campaigns/-1」，然後在第二個作業中建立廣告群組，並在第二個作業中建立「customers/1234/campaigns/-1」廣告活動欄位，藉此在同一個廣告活動中建立廣告活動和廣告群組。

回應主體

對「BatchJobService.AddBatchJobOperations」的回應訊息。

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

JSON 表示法 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
欄位
totalOperations

string (int64 format)

這項批次工作目前為止新增的作業總數。
nextSequenceToken

string

如果必須新增更多作業，則再次呼叫 batchJobs.addOperations 時使用的序列符記。下一個批次工作.addOperations 要求必須將「serialToken」欄位設為這個欄位的值。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。