Method: customers.customInterests.mutate

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v14/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

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