משנה מינוי נתון עם הפרמטרים הרלוונטיים החלים.
רשימת שגיאות שהמערכת ביצעה: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError
בקשת HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendationSubscriptions:mutateRecommendationSubscription
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
חובה. המזהה של הלקוח שנרשם למינוי. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "operations": [ { object ( |
שדות | |
---|---|
operations[] |
חובה. הרשימה של פעולות יצירה או עדכון. |
partialFailure |
אם הערך הוא true, פעולות שבוצעו בהצלחה ופעולות לא חוקיות יחזירו שגיאות. אם הערך הוא False, כל הפעולות יבוצעו בעסקה אחת אם ורק אם כולן תקינות. ברירת המחדל היא False. |
validateOnly |
אם הערך הוא True, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות מוחזרות, לא תוצאות. |
responseContentType |
ההגדרה של סוג התוכן של התשובה. המדיניות הזו קובעת אם המערכת תחזיר את המשאב שניתן לשינוי או רק את שם המשאב אחרי השינוי. המשאב שניתן לשינוי יוחזר רק אם המשאב כולל את שדה התגובה המתאים. לדוגמה, MutateCampaign Results.campaign. |
גוף התשובה
הודעת תגובה ל-[RecommendationSubscriptionService.MutateRecommendationSubscription]
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "results": [ { object ( |
שדות | |
---|---|
results[] |
תוצאות, אחת לכל פעולה. |
partialFailureError |
שגיאות שקשורות לכשלים בפעולה במצב כשל חלקי. הפונקציה מוחזרת רק כאשר PartFailure = true וכל השגיאות מתרחשות בתוך הפעולות. אם מתרחשות שגיאות מחוץ לפעולות (למשל, שגיאות אימות), נחזיר את השגיאה ברמת ה-RPC. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/adwords
למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.