Method: customers.batchJobs.mutate

تغيير مهمة مجمّعة.

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

طلب HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/batchJobs:mutate

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

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

المعلمات
customerId

string

مطلوبة. رقم تعريف العميل المطلوب إنشاء مهمة مجمّعة له

نص الطلب

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

تمثيل JSON 
{
  "operation": {
    object (BatchJobOperation)
  }
}
الحقول
operation

object (BatchJobOperation)

مطلوبة. يشير ذلك المصطلح إلى العملية التي يتم تنفيذها على مهمة مجمّعة فردية.

نص الاستجابة

رسالة ردّ على BatchJobService.MutateBatchJob.

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

تمثيل JSON 
{
  "result": {
    object (MutateBatchJobResult)
  }
}
الحقول
result

object (MutateBatchJobResult)

نتيجة دالة mutate.

نطاقات الأذونات

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

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

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

BatchJobOperation

يشير ذلك المصطلح إلى عملية واحدة على مهمة مجمّعة.

تمثيل JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (BatchJob)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
الحقول
حقل الاتحاد operation. عملية التبديل. يمكن أن يكون operation واحدًا فقط مما يلي:
create

object (BatchJob)

عملية الإنشاء: لا يُتوقع اسم مورد للمهمة الجديدة المجمّعة.
remove

string

عملية الإزالة: يجب ألا يكون قد تم تشغيل المهمة المجمّعة. يُتوقَّع اسم مورد للمهمة المجمّعة التي تمت إزالتها بالتنسيق التالي:

customers/{customerId}/batchJobs/{batch_job_id}

MutateBatchJobResult

نتيجة تغيير المهمة المجمّعة.

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

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