Method: customers.campaignGroups.mutate

יצירה, עדכון או הסרה של קבוצות קמפיינים. מוחזרים סטטוסים של פעולות.

בקשת HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/campaignGroups:mutate

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

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

פרמטרים
customerId

string

חובה. המזהה של הלקוח שבקבוצות הקמפיינים שלו מתבצע שינוי.

גוף הבקשה

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

ייצוג JSON 
{
  "operations": [
    {
      object (CampaignGroupOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
שדות
operations[]

object (CampaignGroupOperation)

חובה. רשימת הפעולות שצריך לבצע בקבוצות קמפיינים נפרדות.
partialFailure

boolean

אם הערך הוא True, פעולות יבוצעו בהצלחה ופעולות לא חוקיות יחזירו שגיאות. אם הערך הוא False, כל הפעולות יבוצעו בעסקה אחת רק אם הן חוקיות. ברירת המחדל היא False.
validateOnly

boolean

אם הערך הוא True, הבקשה מאומתת אבל לא מבוצעת. מוצגות רק שגיאות, ולא תוצאות.
responseContentType

enum (ResponseContentType)

הגדרת סוג התוכן של התשובה. הפונקציה קובעת אם צריך להחזיר את המשאב שניתן לשינוי או רק את שם המשאב אחרי המוטציה.

גוף התשובה

הודעת תשובה לגבי שינוי בקבוצת קמפיינים.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "results": [
    {
      object (MutateCampaignGroupResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
שדות
results[]

object (MutateCampaignGroupResult)

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

object (Status)

שגיאות שנוגעות לכשלים בפעולות במצב 'כשל חלקי'. מוחזר רק כאשרpartFailure = true וכל השגיאות מתרחשות בתוך הפעולות. אם מתרחשות שגיאות מחוץ לפעולות (לדוגמה, שגיאות אימות), אנחנו מחזירים שגיאה ברמת ה-RPC.

היקפי ההרשאות

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

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

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