Method: customers.customInterests.mutate

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

רשימת השגיאות שהמערכת זרקה: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

בקשת HTTP

POST https://googleads.googleapis.com/v19/customers/{customerId}/customInterests:mutate

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

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

פרמטרים
customerId

string

חובה. המזהה של הלקוח שתחומי העניין המותאמים אישית שלו משתנים.

גוף הבקשה

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

ייצוג ב-JSON 
{
  "operations": [
    {
      object (CustomInterestOperation)
    }
  ],
  "validateOnly": boolean
}
שדות
operations[]

object (CustomInterestOperation)

חובה. רשימת הפעולות לביצוע בתחומי עניין מותאמים אישית נפרדים.
validateOnly

boolean

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

גוף התשובה

הודעת התגובה עבור שינוי (mutate) של תחום עניין מותאם אישית.

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

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

object (MutateCustomInterestResult)

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

היקפי הרשאה

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

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

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

CustomInterestOperation

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

ייצוג ב-JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomInterest)
  },
  "update": {
    object (CustomInterest)
  }
  // End of list of possible types for union field operation.
}
שדות
updateMask

string (FieldMask format)

FieldMask שמגדיר אילו שדות של המשאב ישתנו בעדכון.

זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
שדה האיחוד operation. פעולת השינוי. הערך של operation יכול להיות רק אחת מהאפשרויות הבאות:
create

object (CustomInterest)

פעולת יצירה: לא צפוי שם משאב לתחום העניין החדש בהתאמה אישית.
update

object (CustomInterest)

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

MutateCustomInterestResult

התוצאה של המוטציה של תחום העניין המותאם אישית.

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

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