Method: accounts.brands.patch

עדכון של מותג.

בקשת HTTP

PATCH https://travelpartner.googleapis.com/v3/{brand.name=accounts/*/brands/*}

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
brand.name

string

פלט בלבד. שם המשאב של המותג בפורמט accounts/{account_id}/brands/{brandId}. הערך brandId תואם למזהה המותג של השותף שמשמש להתאמת דף הנחיתה ולמזהה המותג ברמת הנכס.

מותג ברירת מחדל מוחל על נכסים שלא משויך להם מותג. ה-brandId של המותג שמוגדר כברירת מחדל הוא NO_BRAND_ID. אפשר לאחזר ולעדכן אותו כמו כל מותג מוגדר.

פרמטרים של שאילתה

פרמטרים
updateMask

string (FieldMask format)

חובה. השדה לעדכון. אפשר לעדכן רק את השדות displayNames ו-icon. משתמשים בתחביר שמוצג ב-URI לדוגמה שבהמשך ומספקים את הערך החדש בגוף הבקשה.

דוגמה ל-URI של בקשה ולגוף הבקשה:

PATCH https://travelpartner.googleapis.com/v3/accounts/123456789/
brands/my-brand?updateMask=brand.display_names

 {
   "displayNames": [{
     "language": "en"
     "text": "Gilles' Gites"
   }]
 }

המידע שלמעלה מספיק כדי ליצור את ה-URI ואת גוף הבקשה. המשפט הבא נוצר באופן אוטומטי, והוא כולל מידע נוסף על הפורמט FieldMask באופן כללי.

זוהי רשימה של שמות שדות שמוגדרים במלואם, שמופרדים באמצעות פסיקים. דוגמה: "user.displayName,photo"
allowMissing

boolean

אם הערך הוא true והמותג לא נמצא, ייווצר מותג חדש. במצב כזה, המערכת מתעלמת מהמדיניות updateMask.

גוף הבקשה

גוף הבקשה מכיל מופע של Brand.

גוף התשובה

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/travelpartner

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.