پردازش دسته‌ای

درحالی‌که اکثر سرویس‌ها میاناهای برنامه‌سازی کاربردی همگام ارائه می‌دهند که شما را ملزم می‌کند درخواست کنید و سپس منتظر پاسخ بمانید، BatchJobService راهی برای انجام دسته‌ای عملیات در چندین سرویس بدون انتظار همگام برای تکمیل عملیات ارائه می‌دهد.

برخلاف عملیات جهش مختص سرویس، یک کار در BatchJobService می‌تواند دربرابر مجموعه‌ای مختلط از پویش‌ها، گروه‌های آگهی، آگهی‌ها، معیارها، برچسب‌ها، و دارایی‌ها عمل کند. کارهای ارسال‌شده به‌طور موازی اجرا می‌شوند و BatchJobService به‌طور خودکار عملیات‌هایی را که به‌دلیل خطاهای گذرا مانند خطاهای محدودیت نرخ ناموفق بوده‌اند، دوباره امتحان می‌کند. «میانای برنامه‌سازی کاربردی Google Ads» همچنان هر عملیات را در حد عملیات روزانه شما محاسبه می‌کند و از دستورالعمل‌های شمارش عملیات میانای برنامه‌سازی کاربردی پیروی می‌کند.

BatchJobService همچنین به شما امکان می‌دهد از شناسه‌های موقت در درخواست‌هایتان استفاده کنید تا بتوانید عملیات وابسته را در یک کار ارسال کنید.

عملیات

BatchJobService از همه عملیات‌های فهرست‌شده در MutateOperation که سرویس زیربنایی آن‌ها از خرابی جزئی پشتیبانی می‌کند، و همچنین AssetGroupOperation و AssetGroupListingGroupFilterOperation که به‌طور صریح مستثنا شده‌اند و (همراه با عملیات‌های وابسته مرتبط) در دسته‌های فرعی اتمی اجرا می‌شوند پشتیبانی می‌کند.

چون Google Ads API عملیات استاندارد را در کاری با شکست جزئی فعال‌شده اجرا می‌کند (به‌جز در دسته‌های فرعی اتمی)، اگر کاری لغو شود یا عملیات‌های تکی ناموفق باشند، عملیات‌هایی که موفق بوده‌اند به حالت قبل برگردانده نمی‌شوند.

عملیات زیر در MutateOperation باید اتمی باشد و از شکست جزئی پشتیبانی نمی‌کند، بنابراین در کارهای دسته‌ای پشتیبانی نمی‌شود. افزودن هریک از این عملیات به کار دسته‌ای خطای MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE برمی‌گرداند (یا InternalError.INTERNAL_ERROR برای BookCampaignsOperation و QuoteCampaignsOperation). درعوض، آن‌ها را بااستفاده از GoogleAdsService.Mutate با partial_failure تنظیم‌شده روی false (و validate_only تنظیم‌شده روی true برای QuoteCampaignsOperation) اجرا کنید.

عملیات پشتیبانی‌نشده در BatchJobService

بعدی
جریان استفاده