Method: customers.adGroupCriteria.mutate

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

רשימת השגיאות {/4999 {שם {300999000 00 00 להגדיר ו { אחרים אחריםאים לגרסה {I'). {IIIIErrorService{Cכמות משנה}{אין שגיאה{/19 {Error שיוגדר {99 {Error שיוגדר{9900000 הגורם הגורם כאן שגיאה{/99 {ErrorName}Error שיוגדרוAdGroupCriterionErrorAdxErrorAuthenticationErrorAuthorizationErrorBiddingErrorBiddingStrategyErrorCollectionSizeErrorContextErrorCriterionErrorDatabaseErrorDateErrorDistinctErrorFieldErrorFieldMaskErrorHeaderErrorIdErrorInternalErrorMultiplierErrorMutateErrorNewResourceCreationErrorNotEmptyErrorNullErrorOperationAccessDeniedErrorOperatorErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldError

בקשת HTTP

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

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

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

פרמטרים
customerId

string

חובה. מזהה של הלקוח שהקריטריונים שלו משתנים.

גוף הבקשה

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

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

object (AdGroupCriterionOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

גוף התשובה

הודעת תגובה לשינוי קריטריון של קבוצת מודעות.

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

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

object (Status)

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

object (MutateAdGroupCriterionResult)

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

היקפי הרשאות

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

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

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