Method: customers.batchJobs.addOperations

バッチジョブにオペレーションを追加します。

スローされるエラーのリスト: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
resourceName

string

必須。バッチジョブのリソース名。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
フィールド
sequenceToken

string

シーケンスを適用するために使用されるトークン。

バッチジョブの最初の batchJobs.addOperations リクエストで sequenceToken を設定しないでください。後続のリクエストでは、sequenceToken を、前の batchJobs.addOperations レスポンスで受信した nextSequenceToken の値に設定する必要があります。
mutateOperations[]

object (MutateOperation)

必須。追加されるミューテーションのリスト。

オペレーションでは、負の整数を一時 ID として使用して、このバッチジョブで作成されたエンティティ間の依存関係を示すことができます。たとえば、id = 1234 のお客様は、最初のオペレーションでリソース名を明示的に「customers/1234/campaigns/-1」に設定してキャンペーンを作成し、2 番目のオペレーションでキャンペーン フィールドも「customers/1234/campaigns/-1」に設定して広告グループを作成することで、キャンペーンとそのキャンペーン内の広告グループを作成できます。

レスポンスの本文

BatchJobService.AddBatchJobOperations に対するレスポンス メッセージです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
フィールド
totalOperations

string (int64 format)

このバッチジョブでこれまでに追加されたオペレーションの合計数。
nextSequenceToken

string

追加のオペレーションを追加する必要がある場合に、batchJobs.addOperations を再度呼び出すときに使用されるシーケンス トークン。次の batchJobs.addOperations リクエストでは、sequenceToken フィールドをこのフィールドの値に設定する必要があります。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 Overview をご覧ください。