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

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

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

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

العمليات

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

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

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

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

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