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

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

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

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

العمليات

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

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

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

العمليات غير المتاحة في BatchJobService

التالي
تدفق الاستخدام