Method: customers.adGroupAds.mutate

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

רשימת השגיאות שהמערכת זרקה: AdCustomizerError AdError AdGroupAdError AdSharingError AdxError AssetError AssetLinkError AuthenticationError AuthorizationError CollectionSizeError ContextError DatabaseError DateError DistinctError FeedAttributeReferenceError FieldError FieldMaskError FunctionError FunctionParsingError HeaderError IdError ImageError InternalError ListOperationError MediaBundleError MediaFileError MutateError NewResourceCreationError NotEmptyError NullError OperationAccessDeniedError OperatorError PolicyFindingError PolicyValidationParameterError PolicyViolationError QuotaError RangeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError UrlFieldError

בקשת HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAds:mutate

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

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

פרמטרים
customerId

string

חובה. המזהה של הלקוח שהמודעות שלו משתנות.

גוף הבקשה

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

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

object (AdGroupAdOperation)

חובה. רשימת הפעולות שצריך לבצע במודעות בודדות.
partialFailure

boolean

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

boolean

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

enum (ResponseContentType)

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

גוף התשובה

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

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

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

object (Status)

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

object (MutateAdGroupAdResult)

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

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

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

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

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