Method: customers.customerAssetSets.mutate

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

בקשת HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/customerAssetSets:mutate

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
customerId

string

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

גוף הבקשה

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

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

object (CustomerAssetSetOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

גוף התשובה

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

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

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

object (MutateCustomerAssetSetResult)

כל התוצאות עבור השינוי.
partialFailureError

object (Status)

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

היקפי הרשאות

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

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

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

CustomerAssetSetOperation

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

ייצוג JSON 
{

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

object (CustomerAssetSet)

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

string

פעולת ההסרה: צפוי שם משאב לקבוצת נכסי הלקוח שהוסרה, בפורמט הבא: customers/{customerId}/customerAssetSets/{asset_set_id}

MutateCustomerAssetSetResult

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

ייצוג JSON 
{
  "resourceName": string,
  "customerAssetSet": {
    object (CustomerAssetSet)
  }
}
שדות
resourceName

string

מוחזר עבור פעולות שבוצעו בהצלחה.
customerAssetSet

object (CustomerAssetSet)

נכס הלקוח שעבר שינוי מוגדר עם שדות שניתנים לשינוי בלבד אחרי השינוי. השדה יוחזר רק כאשר responseContentType מוגדר כ-"MUTABLE_Resource".