הוספת פעולות למשימה באצווה.
רשימה של שגיאות התרעה: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError
בקשת HTTP
POST https://googleads.googleapis.com/v14/{resourceName=customers/*/batchJobs/*}:addOperations
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
resourceName |
חובה. שם המשאב של המשימה באצווה. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"sequenceToken": string,
"mutateOperations": [
{
object ( |
שדות | |
---|---|
sequenceToken |
אסימון שמשמש לאכיפת יצירת רצף. הבקשה הראשונה BundleJobs.addOperations למשימת אצווה לא צריכה להגדיר}{SetToken. הבקשות הבאות חייבות להגדיר את queryToken לערך של nextSequenceToken שהתקבל בתגובה הקודמת robots.addOperations. |
mutateOperations[] |
חובה. רשימת השינויים שנוספו. פעולות יכולות להשתמש במספרים שלמים שליליים כמזהי זמניים כדי לציין יחסי תלות בין ישויות שנוצרו במשימת האצווה הזו. לדוגמה, לקוח עם המזהה = 1234 יכול ליצור קמפיין וקבוצת מודעות באותו קמפיין על ידי יצירת קמפיין בפעולה הראשונה, שבו שם המשאב מוגדר במפורש כ-"customers/1234/campaigns/-1", ויצירת קבוצת מודעות בפעולה השנייה עם שדה הקמפיין גם מוגדר כ-"customers/1234/campaigns/-1". |
גוף התגובה
הודעת תשובה לגבי BatchJobService.AddBatchJobOperations
.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{ "totalOperations": string, "nextSequenceToken": string } |
שדות | |
---|---|
totalOperations |
המספר הכולל של פעולות שנוספו עד כה למשימה הזו באצווה. |
nextSequenceToken |
אסימון הרצף שבו יש להשתמש בעת קריאה חוזרת ל-BbatJobs.addOperations יש צורך בהוספת פעולות נוספות. הבקשה הבאה BatJobs.addOperations חייבת להגדיר את השדהSequenceToken לערך של השדה הזה. |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/adwords
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.