Method: customers.keywordPlanAdGroups.mutate

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

רשימת השגיאות שהמערכת זרקה: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError KeywordPlanAdGroupError KeywordPlanError MutateError NewResourceCreationError QuotaError RequestError ResourceCountLimitExceededError

בקשת HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/keywordPlanAdGroups:mutate

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
customerId

string

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

גוף הבקשה

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

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

object (KeywordPlanAdGroupOperation)

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

boolean

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

boolean

אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת. המערכת מחזירה רק שגיאות, לא תוצאות.

גוף התשובה

הודעת תגובה לגבי שינוי (mutate) של קבוצת מודעות בתוכנית למילות מפתח.

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

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

object (Status)

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

object (MutateKeywordPlanAdGroupResult)

כל התוצאות של ה-mutate. הסדר של התוצאות נקבע לפי הסדר של מילות המפתח בבקשה המקורית.

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

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

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

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