יצירת מאפייני התאמה אישית, עדכון שלהם או הסרה שלהם. הסטטוסים של הפעולות מוחזרים.
בקשת HTTP
POST https://googleads.googleapis.com/v19/customers/{customerId}/customizerAttributes:mutate
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
חובה. המזהה של הלקוח שהמאפיינים של הפרמטר להתאמה אישית שלו משתנים. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{ "operations": [ { object ( |
שדות | |
---|---|
operations[] |
חובה. רשימת הפעולות לביצוע במאפייני התאמה אישית נפרדים. |
partialFailure |
אם הערך הוא true, פעולות מוצלחות יבוצעו ופעולות לא חוקיות יחזירו שגיאות. אם הערך הוא false, כל הפעולות יבוצעו בעסקה אחת רק אם כולן תקינות. ברירת המחדל היא FALSE. |
validateOnly |
אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת. המערכת מחזירה רק שגיאות, לא תוצאות. |
responseContentType |
ההגדרה של סוג התוכן של התגובה. ההגדרה קובעת אם צריך להחזיר את המשאב שניתן לשינוי או רק את שם המשאב לאחר המוטציה. |
גוף התשובה
הודעת התגובה עבור שינוי של מאפיין מותאם אישית.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{ "results": [ { object ( |
שדות | |
---|---|
results[] |
כל התוצאות של ה-mutate. |
partialFailureError |
שגיאות שקשורות לכשלים בפעולות במצב של כשל חלקי. הפונקציה מחזירה את הערך הזה רק אם partialFailure = true וכל השגיאות מתרחשות בתוך הפעולות. אם יצוצו שגיאות מחוץ לפעולות (לדוגמה, שגיאות אימות), אנחנו מחזירים שגיאה ברמת ה-RPC. |
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/adwords
מידע נוסף זמין בOAuth 2.0 Overview.