Method: accounts.hotels.setLiveOnGoogle

שיטה מותאמת אישית ברמת האוסף לעדכון הסטטוס 'פעיל ב-Google' של מספר נכסים. בכל שיחה אפשר להפעיל או להשבית כמה מלונות. כדי להפעיל מלונות מסוימים ולהשבית מלונות אחרים, תצטרכו לבצע כמה שיחות.

בקשת HTTP

POST https://travelpartner.googleapis.com/v3/{account=accounts/*}/hotels:setLiveOnGoogle

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

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

פרמטרים
account

string

חובה. שם המשאב של החשבון. הפורמט הוא accounts/{account_id}.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "liveOnGoogle": boolean,
  "partnerHotelIds": [
    string
  ],
  "liveOnGoogleStatus": enum (LiveOnGoogleStatus)
}
שדות
liveOnGoogle
(deprecated)

boolean

אופציונלי. הוצא משימוש. האם הנכס יוצג ב-Google. אם הערך הוא true, ‏ Google תציג את הנכסים אם השילוב שלהם הושלם והנכס זמין. אם הערך הוא false, ‏ Google לעולם לא תציג את המאפיינים.

הוחלפה על ידי גרסת liveOnGoogleStatus.

צריך להגדיר רק אחד מהמאפיינים liveOnGoogle או liveOnGoogleStatus. אם מגדירים את שניהם, המערכת תשתמש במאפיין liveOnGoogleStatus.
partnerHotelIds[]

string

חובה. מזהה את המאפיינים לעדכון בהגדרה liveOnGoogle.
liveOnGoogleStatus

enum (LiveOnGoogleStatus)

אופציונלי. האם הנכס יוצג ב-Google, עם אמצעי בקרה מפורטים יותר מאשר השדה הבוליאני המקורי liveOnGoogle.

צריך להגדיר רק אחד מהמאפיינים liveOnGoogle או liveOnGoogleStatus. אם מגדירים את שניהם, המערכת תשתמש במאפיין liveOnGoogleStatus.

הערה: צריך להקיף את השדה הזה במירכאות. לדוגמה, "LIVE_ON_GOOGLE_STATUS_INACTIVE".

גוף התשובה

הודעת תגובה לHotelService.SetLiveOnGoogle.

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

ייצוג ב-JSON 
{
  "updatedHotelIds": [
    string
  ],
  "failedHotelIds": [
    string
  ]
}
שדות
updatedHotelIds[]

string

מציין את המאפיינים המעודכנים.
failedHotelIds[]

string

זיהוי מאפיינים ש-Google לא הצליחה לעדכן.

היקפי הרשאות

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

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

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