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

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

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

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

العمليات

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

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

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

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