پردازش دسته‌ای روشی برای ارسال مجموعه‌ای از عملیات‌ها (که ممکن است به یکدیگر وابسته باشند) به چندین سرویس بدون انتظار هم‌زمان برای تکمیل عملیات‌ها ارائه می‌دهد. می‌توانید از پردازش دسته‌ای برای ایجاد و مدیریت کمپین‌های «عملکرد بیشینه» استفاده کنید.
این راهنما جزئیات خاصی را درباره پویش‌های «عملکرد بیشینه» هنگام کار با پردازش دسته‌ای ارائه می‌دهد. راهنمای پردازش دسته‌ای عمومی اطلاعات کلی درباره پردازش دسته‌ای ارائه می‌دهد و راهنمای ساختار درخواست‌ها حاوی اطلاعات دقیق درباره ساخت درخواست‌ها برای ایجاد یا مدیریت پویش‌های «بیشینه‌سازی عملکرد» است.
برای ایجاد پویش «عملکرد بیشینه» بااستفاده از پردازش دسته‌ای، این مراحل را دنبال کنید:
ایجاد کار دسته‌ای جدید
برای ایجاد منبع BatchJob،
مرحله ایجاد کار پردازش دسته‌ای عمومی را دنبال کنید.
فهرستی از عملیات تغییر آماده کنید
پویش‌های «عملکرد بیشینه» برای ایجاد چندین منبع مرتبط به عملیات نیاز دارند که در
راهنمای درخواست‌های ساختار به‌طور مفصل شرح داده شده است. برای هر منبعی که باید در کار دسته‌ای گنجانده شود، یک
MutateOperation ایجاد کنید.
الزامات CampaignOperation و CampaignAssetOperation
وقتی رهنمودهای نمانام برای پویشی فعال باشد (به
رهنمودهای نمانام مراجعه کنید)، باید بااستفاده از منابع CampaignAsset،
دارایی‌های نمانام را به پویش پیوند دهید. علاوه‌براین، در کار دسته‌ای، ایجاد این منابع CampaignAsset باید بلافاصله پس‌از ایجاد خود منبع Campaign انجام شود. اگر منابع CampaignAsset بلافاصله پس‌از منبع Campaign ایجاد نشوند (وقتی رهنمودهای نمانام فعال باشد - عیب‌یابی را ببینید)،
درخواست ناموفق خواهد بود و CampaignError را برمی‌گرداند که نشان‌دهنده دارایی‌های ازدست‌رفته است.
افزودن عملیات ایجاد CampaignAsset در ادامه همان فهرست عملیات مانع این خطا نخواهد شد.
الزامات AssetGroupOperation و AssetGroupAssetOperation
عملیات‌های نوع MutateOperation که
منابع AssetGroup و
AssetGroupAsset را در کار دسته‌ای ایجاد می‌کنند باید
متوالی باشند و عملیات دیگری بین آن‌ها نباشد، زیرا این
عملیات‌ها هنگام پردازش باهم گروه‌بندی می‌شوند. درغیراین‌صورت، درخواست
AssetGroupError را برمی‌گرداند که نشان می‌دهد برخی‌از دارایی‌ها
وجود ندارند،
حتی اگر عملیات لازم برای
برآورده کردن حداقل الزامات دارایی بعداً در فهرست عملیات
گنجانده شده باشد.
روال‌های مطلوب AssetGroupListingGroupFilterOperation
هنگام کار با فیلترهای گروه فهرستگان در بافت
AssetGroupListingGroupFilter، توصیه می‌کنیم
AssetGroupListingGroupFilterOperation
عملیات هدف‌یابی همان AssetGroup را به‌طور متوالی به
کار دسته‌ای اضافه کنید تا مجموعه عملیات درطول تقسیم دسته‌ای به‌صورت اتمی
درنظر گرفته شود. برای خواندن بیشتر درباره تقسیم دسته‌ای و عوامل دیگری که بر گروه‌های فهرستگان تأثیر می‌گذارند،
راهنمای پردازش دسته‌ای گروه فهرستگان را ببینید.
افزودن عملیات تغییر به کار
عملیات جهش را از مرحله ۲ به فهرست اضافه کنید و
AddBatchJobOperations
را فراخوانی کنید تا فهرست جهش‌ها به کار دسته‌ای ایجادشده در مرحله ۱ اضافه شود.
مرحله افزودن عملیات را در راهنمای کلی پردازش دسته‌ای دنبال کنید تا فهرست عملیات تغییر را اضافه کنید.
اجرای کار دسته‌ای
با فراخوانی کردن
RunBatchJob، به کارهای بارگذاری‌شده اجازه دهید اجرا شوند. برای مشاهده نمونه، مرحله
اجرای کار دسته‌ای
را در راهنمای کلی پردازش دسته‌ای ببینید.
بازیابی وضعیت کار
کارهای دسته‌ای به‌عنوان عملیات طولانی‌مدت شروع می‌شوند و معمولاً مدتی طول می‌کشد تا تمام شوند.
پس‌از شروع کار، از روش
GetOperation
عملیات طولانی‌مدت برای نظرسنجی وضعیت کار
تا زمان تکمیل آن استفاده کنید.
وقتی همه کارهای دسته‌ای شما تمام شد،
ListBatchJobResults را فراخوانی کنید تا
وضعیت‌ها و پاسخ‌های آن‌ها را طبق
مرحله فهرست کردن همه نتایج کار دسته‌ای در
راهنمای پردازش دسته‌ای عمومی چاپ کنید.