Method: customers.adGroupAssetSets.mutate

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת 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)

כל התוצאות עבור השינוי.
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".