יוצר, מעדכן או מסיר הגדרות של תוספים בקבוצת מודעות. הסטטוסים של הפעולות מוחזרים.
רשימת שגיאות sendn: AuthenticationError AuthorizationError CollectionSizeError CriterionError DatabaseError DateError DistinctError ExtensionSettingError FieldError FieldMaskError FieldMaskError FieldMaskErrorHeaderErrorIdErrorInternalErrorListOperationErrorMutateErrorNewResourceCreationErrorNotEmptyErrorNullErrorOperationAccessDeniedErrorOperatorErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldError
בקשת HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}/adGroupExtensionSettings:mutate
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
חובה. מזהה הלקוח שמשנים את ההגדרות של התוספים לקבוצת המודעות. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"operations": [
{
object ( |
שדות | |
---|---|
operations[] |
חובה. רשימת הפעולות שיש לבצע על הגדרות של תוספים בודדים בקבוצת מודעות. |
partialFailure |
אם הערך הוא true, יבוצעו פעולות מוצלחות ופעולות לא חוקיות יחזירו שגיאות. אם הערך הוא False, כל הפעולות יבוצעו בעסקה אחת אך ורק אם כולן תקינות. ברירת המחדל היא False. |
validateOnly |
אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות מוחזרות, לא תוצאות. |
גוף התגובה
הודעת תגובה לשינוי הגדרת תוסף ברמת קבוצת המודעות.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{ "partialFailureError": { object ( |
שדות | |
---|---|
partialFailureError |
שגיאות שמתייחסות לכשלים בפעולה במצב כשל חלקי. הפונקציה מוחזרת רק כאשר PartFailure = true וכל השגיאות מתרחשות בתוך הפעולות. אם מתרחשות שגיאות שלא בוצעו מחוץ לפעולות (למשל, שגיאות אימות), נחזיר הודעת שגיאה ברמת ה-RPC. |
results[] |
כל התוצאות עבור השינוי. |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/adwords
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.