Method: customers.batchJobs.addOperations

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

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

בקשת HTTP

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

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

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

פרמטרים
resourceName

string

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

גוף הבקשה

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

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

string

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

הבקשה הראשונה fileJobs.addOperations למשימה באצווה לא צריכה להגדיר את shapeToken. הבקשות הבאות חייבות להגדיר אתSequenceToken לערך של nextSequenceToken שהתקבל בתגובה הקודמת fileJobs.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.