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