Method: accounts.hotelViews.list

הפונקציה מחזירה את רשימת הצפיות במלונות.

בקשת HTTP

GET https://travelpartner.googleapis.com/v3/{parent=accounts/*}/hotelViews

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

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

פרמטרים
parent

string

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

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

פרמטרים
pageSize

integer

מספר הרכיבים לאחזור בדף יחיד.
pageToken

string

אסימון של הדף לאחזור.
filter

string

אופציונלי. התנאים (שדות וביטויים) שמשמשים לסינון של HotelViews. במקרה של האופרטור in, צריך להוסיף רווחים משני הצדדים שלו. אחרת, אפשר להשמיט את הרווחים.

אי אפשר לצרף את התנאים.

אפשר להשתמש בשדה hotelId כדי לבחור מלונות ספציפיים.

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

אפשר להשתמש בשדה matchStatus כדי לסנן את רשימת נתוני HotelViews שמוחזרים לחשבון.

דוגמאות לתנאים תקינים ולתחביר שלהם:

  • hotelId = 'hotel_ABC'
  • hotelId in ('hotel_ABC', 'hotel_XYZ')
  • liveOnGoogle = 'TRUE'
  • liveOnGoogle = 'FALSE'
  • matchStatus = 'NOT_MATCHED'
  • matchStatus in ('NOT_MATCHED', 'MATCHED', 'MAP_OVERLAP')

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעת תגובה לHotelViewService.ListHotelViews.

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

ייצוג ב-JSON 
{
  "hotelViews": [
    {
      object (HotelView)
    }
  ],
  "nextPageToken": string
}
שדות
hotelViews[]

object (HotelView)

רשימת השורות שתואמות לשאילתה.
nextPageToken

string

אסימון עימוד שמשמש לאחזור של דף התוצאות הבא.

היקפי הרשאות

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

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

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