عملیات را به کار دسته ای اضافه کنید.
فهرست خطاهای پرتاب شده: AuthenticationError AuthorizationError BatchJobError HeaderError داخلی خطا QuotaError RequestError ResourceCountLimitExceededError
درخواست HTTP
POST https://googleads.googleapis.com/v17/{resourceName=customers/*/batchJobs/*}:addOperations
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
resourceName | ضروری. نام منبع کار دسته ای. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"sequenceToken": string,
"mutateOperations": [
{
object ( |
زمینه های | |
---|---|
sequenceToken | نشانه ای که برای اجرای توالی استفاده می شود. اولین درخواست batchJobs.addOperations برای یک کار دسته ای نباید sequenceToken را تنظیم کند. درخواستهای بعدی باید sequenceToken را روی مقدار nextSequenceToken دریافت شده در پاسخ batchJobs.addOperations قبلی تنظیم کنند. |
mutateOperations[] | ضروری. لیست جهش یافته ها اضافه می شود. عملیات می تواند از اعداد صحیح منفی به عنوان شناسه موقت برای نشان دادن وابستگی بین موجودیت های ایجاد شده در این کار دسته ای استفاده کند. به عنوان مثال، یک مشتری با id = 1234 می تواند یک کمپین و یک گروه تبلیغاتی را در همان کمپین با ایجاد یک کمپین در اولین عملیات با نام منبع به صراحت روی "customers/1234/campaigns/-1" و ایجاد یک کمپین ایجاد کند. گروه تبلیغاتی در عملیات دوم با فیلد کمپین نیز روی «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 مراجعه کنید.