バッチジョブにオペレーションを追加します。
スローされるエラーのリスト: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError
HTTP リクエスト
POST https://googleads.googleapis.com/v14/{resourceName=customers/*/batchJobs/*}:addOperations
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
resourceName |
必須。バッチジョブのリソース名。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{
"sequenceToken": string,
"mutateOperations": [
{
object ( |
フィールド | |
---|---|
sequenceToken |
シーケンスを適用するために使用されるトークン。 バッチジョブの最初の batchJobs.addOperations リクエストでシーケンストークンを設定することはできません。後続のリクエストでは、sequenceToken を前の batchJobs.addOperations レスポンスで受け取った nextSequenceToken の値に設定する必要があります。 |
mutateOperations[] |
必須。追加されるミューテーションのリスト。 オペレーションでは、負の整数を一時 ID として使用して、このバッチジョブで作成されたエンティティ間の依存関係を示すことができます。たとえば、ID = 1234 の顧客は、同じキャンペーン内にキャンペーンと広告グループを作成できます。そのためには、最初のオペレーションでリソース名を明示的に「customers/1234/campaigns/-1」に設定し、2 番目のオペレーションでキャンペーン フィールドも「customers/1234/campaigns/-1」に設定して広告グループを作成します。 |
レスポンスの本文
BatchJobService.AddBatchJobOperations
に対するレスポンス メッセージです。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "totalOperations": string, "nextSequenceToken": string } |
フィールド | |
---|---|
totalOperations |
このバッチジョブに対してこれまでに追加されたオペレーションの合計数。 |
nextSequenceToken |
オペレーションを追加する必要がある場合に batchJobs.addOperations を再度呼び出すときに使用されるシーケンス トークン。次の batchJobs.addOperations リクエストでは、sequenceToken フィールドをこのフィールドの値に設定する必要があります。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/adwords
詳細については、OAuth 2.0 の概要をご覧ください。