Method: customers.batchJobs.addOperations

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

فهرست خطاهای پرتاب شده: AuthenticationError AuthorizationError BatchJobError HeaderError داخلی خطا 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 را روی مقدار 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 Overview .