Method: customers.batchJobs.mutate

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

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

طلب HTTP

POST https://googleads.googleapis.com/v14/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

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