Method: customers.customInterests.mutate

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

רשימת השגיאות שהושלחו: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

בקשת HTTP

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

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

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

פרמטרים
customerId

string

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

גוף הבקשה

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

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

object (CustomInterestOperation)

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

boolean

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

גוף התשובה

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

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

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

object (MutateCustomInterestResult)

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

היקפי הרשאה

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

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

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

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

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