Method: customers.batchJobs.addOperations

أضِف عمليات إلى وظيفة الدُفعة.

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

طلب HTTP

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

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

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

المعلمات
resourceName

string

مطلوب. اسم المورد لطلب الحزمة.

نص الطلب

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

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

string

رمز مميّز يُستخدَم لفرض التسلسل

يجب ألا يضبط الطلب الأول من batchJobs.addOperations لإحدى مهام الدُفعات القيمة sequenceToken. يجب أن تضبط الطلبات اللاحقة مَعلمة sequenceToken على قيمة nextSequenceToken التي تم استلامها في الاستجابة السابقة لطلب batchJobs.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

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

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.