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

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

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

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

عملیات

BatchJobService از تمام عملیات های فهرست شده در MutateOperation پشتیبانی می کند، به جز چند استثنا مهم.

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

عملیات زیر در MutateOperation باید اتمی باشد، و بنابراین، از شکست جزئی پشتیبانی نمی‌کند و در کارهای دسته‌ای پشتیبانی نمی‌شود . از اضافه کردن آنها به مشاغل خود اجتناب کنید، partial_failure در درخواست های خود روی false قرار دهید و به جای آن از روش mutate در GoogleAdsService استفاده کنید.

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