Method: customers.batchJobs.addOperations

מוסיפים פעולות למשימה האצווה.

רשימת השגיאות שהמערכת זורקת: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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.