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

درحالی‌که اکثر سرویس‌ها میاناهای برنامه‌سازی کاربردی همگامی ارائه می‌دهند که شما را ملزم می‌کند درخواست کنید و سپس منتظر پاسخ بمانید، 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