درحالیکه اکثر سرویسها میاناهای برنامهسازی کاربردی همگام ارائه میدهند که شما را ملزم میکند درخواست کنید و سپس منتظر پاسخ بمانید، 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
BookCampaignsOperation(دردسترس درMutateOperation)CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperationQuoteCampaignsOperation(دردسترس درMutateOperation؛ نیاز بهvalidate_onlyتنظیمشده رویtrue)