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

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

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

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

العمليات

تتيح عملية BatchJobService تنفيذ جميع العمليات المُدرَجة في MutateOperation التي تتيح خدمتها الأساسية الفشل الجزئي، بالإضافة إلى AssetGroupOperation وAssetGroupListingGroupFilterOperation، اللتين تم استثناؤهما وتنفيذهما بشكل صريح (إلى جانب العمليات ذات الصلة المترابطة) في الدُفعات الفرعية الذرية.

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

يجب أن تكون العمليات التالية في MutateOperation ذرية ولا تتيح حالات الفشل الجزئي، وبالتالي لا يمكن استخدامها في مهام الدفعات. تؤدي إضافة أي من هذه العمليات إلى مهمة مجمّعة إلى ظهور الخطأ MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE (أو InternalError.INTERNAL_ERROR في حالتي BookCampaignsOperation وQuoteCampaignsOperation). بدلاً من ذلك، نفِّذ هذه العمليات باستخدام GoogleAdsService.Mutate مع ضبط partial_failure على false (وضبط validate_only على true في حالة QuoteCampaignsOperation).

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

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