Method: customers.batchJobs.addOperations

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
resourceName

string

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
שדות
sequenceToken

string

אסימון שמשמש לאכיפת יצירת רצף.

הבקשה הראשונה BundleJobs.addOperations למשימת אצווה לא צריכה להגדיר}{SetToken. הבקשות הבאות חייבות להגדיר את queryToken לערך של nextSequenceToken שהתקבל בתגובה הקודמת robots.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

אסימון הרצף שבו יש להשתמש בעת קריאה חוזרת ל-BbatJobs.addOperations יש צורך בהוספת פעולות נוספות. הבקשה הבאה BatJobs.addOperations חייבת להגדיר את השדהSequenceToken לערך של השדה הזה.

היקפי הרשאות

נדרש היקף OAuth הבא:

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.