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)

התוצאה של השינוי.

היקפי הרשאות

נדרש היקף 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

שם המשאב של המשימה באצווה.