Method: customers.customInterests.mutate

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

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

בקשת HTTP

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

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

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

פרמטרים
customerId

string

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

גוף הבקשה

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

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

object (CustomInterestOperation)

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

boolean

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

גוף התשובה

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

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

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

object (MutateCustomInterestResult)

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של 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

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