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)

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

גוף התשובה

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

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

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

object (MutateAdGroupAssetSetResult)

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

object (Status)

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

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

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

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

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

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.