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