المعالجة المجمّعة

في حين أنّ معظم الخدمات توفّر واجهات برمجة تطبيقات متزامنة تتطلّب منك تقديم طلب ثم الانتظار للحصول على ردّ، يوفّر BatchJobService طريقة لتنفيذ دفعات من العمليات على خدمات متعدّدة بدون الانتظار بشكل متزامن حتى تكتمل العمليات.

على عكس عمليات التحويل الخاصة بالخدمة، يمكن أن تعمل مهمة واحدة في BatchJobService على مجموعة مختلطة من الحملات والمجموعات الإعلانية والإعلانات والمعايير والعلامات وعناصر الخلاصة. يتم تنفيذ المهام المُرسَلة بشكل موازٍ، ومحاولة BatchJobService تلقائيًا إعادة العمليات التي تتعذّر بسبب أخطاء عابرة، مثل أخطاء حدود المعدل. لا تزال Google Ads API تُحصِّل كلّ عملية ضمن الحدّ الأقصى اليومي للعمليات وفقًا لتعليمات احتساب عمليات واجهة برمجة التطبيقات.

بالإضافة إلى ذلك، تتيح لك أداة BatchJobService استخدام المعرّفات المؤقتة في طلباتك حتى تتمكّن من إرسال عمليات مترابطة في مهمة واحدة.

العمليات

يتيح BatchJobService جميع العمليات المدرَجة في MutateOperation، مع بعض الاستثناءات المهمة.

بما أنّ Google Ads API تنفِّذ جميع العمليات في مهمة مع تفعيل تعذُّر جزئي، في حال تم إلغاء العملية أو تعذّر تنفيذ عمليات فردية، لن يتم التراجع عن العمليات التي تمّ إكمالها.

يجب أن تكون العمليات التالية في MutateOperation ذرية، وبالتالي لا تتيح حدوث خطأ جزئي ولا تتيح استخدامها ضمن مهام الدُفعات. تجنَّب إضافتها إلى وظائفك، واضبط partial_failure على false في طلباتك، واستخدِم طريقة mutate في GoogleAdsService بدلاً من ذلك.

العمليات غير المتوافقة في BatchJobService