در حالی که اکثر سرویسها APIهای همزمان را ارائه میکنند، و از شما میخواهند درخواستی ارسال کنید و سپس منتظر پاسخ باشید، BatchJobService
راهی برای انجام دستهای از عملیات روی چندین سرویس بدون انتظار همزمان برای تکمیل عملیات ارائه میکند.
برخلاف عملیات جهش خاص سرویس، یک کار واحد در BatchJobService
میتواند در برابر مجموعهای از کمپینها، گروههای تبلیغاتی، تبلیغات، معیارها، برچسبها و آیتمهای فید عمل کند. کارهای ارسال شده به صورت موازی اجرا می شوند و BatchJobService
به طور خودکار عملیات هایی را که به دلیل خطاهای گذرا مانند خطاهای محدودیت نرخ با شکست مواجه می شوند، دوباره امتحان می کند. API Google Ads همچنان هر عملیات را به دنبال دستورالعملهای شمارش عملیات API در حد عملیات روزانه شما حساب میکند.
علاوه بر این، BatchJobService
به شما امکان می دهد از شناسه های موقت در درخواست های خود استفاده کنید تا بتوانید عملیات وابسته را در یک کار واحد ارسال کنید.
عملیات
BatchJobService
از تمام عملیات های فهرست شده در MutateOperation
پشتیبانی می کند، به جز چند استثنا مهم.
از آنجایی که Google Ads API همه عملیات را در یک کار با شکست جزئی فعال اجرا میکند، اگر یک کار لغو شود یا عملیات فردی با شکست مواجه شود، عملیاتی که با موفقیت انجام شده است، برگشت داده نمیشود .
عملیات زیر در MutateOperation
باید اتمی باشد، و بنابراین، از شکست جزئی پشتیبانی نمیکند و در کارهای دستهای پشتیبانی نمیشود . از اضافه کردن آنها به مشاغل خود اجتناب کنید، partial_failure
در درخواست های خود روی false
قرار دهید و به جای آن از روش mutate
در GoogleAdsService
استفاده کنید.
عملیات پشتیبانی نشده در BatchJobService
-
CampaignConversionGoalOperation
-
ConversionGoalCampaignConfigOperation
-
CustomConversionGoalOperation
-
CustomerConversionGoalOperation
-
CustomerOperation