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)

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

object (MutateAdGroupAdResult)

כל התוצאות של ה-mutate.

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.