Method: customers.batchJobs.addOperations

إضافة عمليات إلى المهمة المجمّعة.

قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

طلب HTTP

POST https://googleads.googleapis.com/v15/{resourceName=customers/*/batchJobs/*}:addOperations

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
resourceName

string

مطلوبة. اسم المورد للمهمة المجمّعة.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
الحقول
sequenceToken

string

يشير هذا المصطلح إلى رمز مميّز يُستخدَم لفرض التسلسل.

يجب ألا يعيّن طلب الدُفعة الأولى لمهمة دُفعة رسالة تسلسلية. يجب أن تعمل الطلبات اللاحقة على ضبط seriesToken (الرمز المميّز التالي) الذي تم استلامه في استجابة paymentJobs.addOperations السابقة.
mutateOperations[]

object (MutateOperation)

مطلوبة. قائمة عمليات التبديل التي تتم إضافتها.

يمكن للعمليات استخدام الأعداد الصحيحة السالبة كأرقام تعريف مؤقتة للدلالة على التبعيات بين الكيانات التي تم إنشاؤها في هذه المهمة المجمّعة. على سبيل المثال، يمكن للعميل الذي يحمل رقم التعريف = 1234 إنشاء حملة ومجموعة إعلانية في الحملة نفسها عن طريق إنشاء حملة في العملية الأولى مع ضبط اسم المورد صراحةً على "customers/1234/campaigns/-1"، وإنشاء مجموعة إعلانية في العملية الثانية مع ضبط حقل الحملة أيضًا على "customers/1234/campaigns/-1".

نص الاستجابة

رسالة الرد على BatchJobService.AddBatchJobOperations.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
الحقول
totalOperations

string (int64 format)

إجمالي عدد العمليات التي تمت إضافتها حتى الآن لهذه المهمة المجمّعة.
nextSequenceToken

string

الرمز المميز للتسلسل الذي سيتم استخدامه عند استدعاء paymentJobs.addOperations مرة أخرى إذا كانت هناك حاجة لإضافة المزيد من العمليات يجب أن يضبط طلب الدُفعة التالي Jobs.addOperations حقل التسلسل ملايين على قيمة هذا الحقل.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adwords

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.