Method: customers.adGroupAssetSets.mutate

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

בקשת HTTP

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

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

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

פרמטרים
customerId

string

חובה. המזהה של הלקוח שקבוצות הנכסים של קבוצות המודעות שלו משתנות.

גוף הבקשה

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

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

object (AdGroupAssetSetOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

גוף התשובה

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

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

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

object (MutateAdGroupAssetSetResult)

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

object (Status)

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

היקפי הרשאה

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

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

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

AdGroupAssetSetOperation

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

ייצוג ב-JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
שדות
שדה האיחוד operation. פעולת השינוי. הערך של operation יכול להיות רק אחת מהאפשרויות הבאות:
create

object (AdGroupAssetSet)

פעולת יצירה: לא צפוי שם משאב לקבוצת הנכסים החדשה של קבוצת המודעות.
remove

string

פעולת ההסרה: נדרש שם משאב של קבוצת הנכסים של קבוצת המודעות שהוסרה, בפורמט הזה: customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

התוצאה של קבוצת הנכסים של קבוצת המודעות משתנה.

ייצוג ב-JSON 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
שדות
resourceName

string

הקוד מוחזר עבור פעולות שהסתיימו בהצלחה.
adGroupAssetSet

object (AdGroupAssetSet)

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