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

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

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

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

العمليات

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

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

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

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

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