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 حذف شده‌اند.

فیلد 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 مراجعه کنید.