Method: customers.campaignExtensionSettings.mutate

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

רשימת שגיאות sendn: AuthenticationError AuthorizationError CollectionSizeError CriterionError DatabaseError DateError DistinctError ExtensionSettingError FieldError FieldMaskError FieldMaskError FieldMaskErrorHeaderErrorIdErrorInternalErrorListOperationErrorMutateErrorNewResourceCreationErrorNotEmptyErrorNullErrorOperationAccessDeniedErrorOperatorErrorQuotaErrorRangeErrorRequestErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldError

בקשת HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/campaignExtensionSettings:mutate

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

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

פרמטרים
customerId

string

חובה. המזהה של הלקוח שהגדרות התוספים בקמפיין שלו משתנות.

גוף הבקשה

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

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

object (CampaignExtensionSettingOperation)

חובה. רשימת הפעולות שיש לבצע בהגדרות של תוספים בודדים בקמפיין.
partialFailure

boolean

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

boolean

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

enum (ResponseContentType)

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

גוף התגובה

הודעת תגובה לשינוי הגדרה של תוסף לקמפיין.

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

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

object (Status)

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

object (MutateCampaignExtensionSettingResult)

כל התוצאות עבור השינוי.

היקפי הרשאות

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

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

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