Method: customers.batchJobs.addOperations

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

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
resourceName

string

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

リクエスト本文

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

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

string

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

バッチジョブの最初の batchJobs.addOperations リクエストでシーケンストークンを設定することはできません。後続のリクエストでは、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 の概要をご覧ください。