درحالیکه اکثر سرویسها میاناهای برنامهسازی کاربردی همگامی ارائه میدهند که شما را ملزم میکند درخواست کنید و سپس منتظر پاسخ بمانید، BatchJobService راهی برای انجام دستهای عملیات در چندین سرویس بدون انتظار همگام برای تکمیل عملیات ارائه میدهد.
برخلاف عملیات جهش مختص سرویس، یک کار واحد در
BatchJobService میتواند روی مجموعهای مختلط از
پویشها، گروههای آگهی، آگهیها، معیارها، برچسبها، و داراییها عمل کند. کارهای ارسالشده بهطور موازی اجرا میشوند و BatchJobService بهطور خودکار عملیاتهایی را که بهدلیل خطاهای گذرا مانند خطاهای محدودیت نرخ ناموفق بودهاند، دوباره امتحان میکند. Google Ads API همچنان هر عملیات را طبق دستورالعملهای شمارش عملیات API در حد عملیات روزانه شما لحاظ میکند.
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تنظیم شده باشد)