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

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

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

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

العمليات

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

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

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

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

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