Method: customers.batchJobs.addOperations

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

قائمة الأخطاء الملموسة: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

طلب HTTP

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

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

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

المَعلمات
resourceName

string

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

نص الطلب

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

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

string

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

يجب ألا يؤدي طلب الدُفعة الأولى للمهمة المجمّعة إلى ضبط واجهة برمجة التطبيقات sortToken. يجب أن تعمل الطلبات اللاحقة على ضبط seriesToken على قيمة nextSequenceToken الذي تم تلقّيه في ردّ 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 التالي على قيمة هذا الحقل في حقل shoppingToken.

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

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

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

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