Method: customers.batchJobs.addOperations

عملیات را به کار دسته ای اضافه کنید.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError BatchJobError HeaderError داخلی خطا QuotaError RequestError ResourceCountLimitExceededError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
resourceName

string

ضروری. نام منبع کار دسته ای.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
زمینه های
sequenceToken

string

نشانه ای که برای اجرای توالی استفاده می شود.

اولین درخواست batchJobs.addOperations برای یک کار دسته ای نباید sequenceToken را تنظیم کند. درخواست‌های بعدی باید sequenceToken را روی مقدار nextSequenceToken دریافت شده در پاسخ batchJobs.addOperations قبلی تنظیم کنند.

mutateOperations[]

object ( MutateOperation )

ضروری. لیست جهش یافته ها اضافه می شود.

عملیات می تواند از اعداد صحیح منفی به عنوان شناسه موقت برای نشان دادن وابستگی بین موجودیت های ایجاد شده در این کار دسته ای استفاده کند. به عنوان مثال، یک مشتری با 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 استفاده می شود. درخواست بعدی batchJobs.addOperations باید فیلد sequenceToken را روی مقدار این فیلد تنظیم کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.