Method: customers.adGroupBidModifiers.mutate

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

רשימת השגיאות שהמערכת זרקה: AdGroupBidModifierError AuthenticationError AuthorizationError ContextError CriterionError DatabaseError DistinctError FieldError FieldMaskError HeaderError IdError InternalError MutateError NewResourceCreationError NotEmptyError OperatorError QuotaError RangeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError

בקשת HTTP

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

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

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

פרמטרים
customerId

string

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

גוף הבקשה

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

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

object (AdGroupBidModifierOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

גוף התשובה

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

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

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

object (Status)

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

object (MutateAdGroupBidModifierResult)

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

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

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

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

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