Method: accounts.hotelViews.list

لیست بازدیدهای هتل را برمی‌گرداند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
parent

string

نام منبع حساب کاربری مورد جستجو. فرمت آن accounts/{account_id} است.

پارامترهای پرس و جو

پارامترها
pageSize

integer

تعداد عناصری که باید در یک صفحه بازیابی شوند.

pageToken

string

توکن صفحه‌ای که قرار است بازیابی شود.

filter

string

اختیاری. شرایط (فیلدها و عبارات) مورد استفاده برای فیلتر کردن HotelViews. این سینتکس نیاز به فاصله در اطراف عملگر in دارد. در غیر این صورت، می‌توان فاصله‌ها را حذف کرد.

شرایط قابل پیوستن نیستند.

از فیلد hotelId می‌توان برای انتخاب هتل‌های خاص استفاده کرد.

فیلد liveOnGoogle می‌تواند ویژگی‌هایی را که گوگل نشان می‌دهد یا ویژگی‌هایی را که در نتایج جستجوی گوگل حذف شده‌اند، انتخاب کند. مقدار «TRUE» شامل ویژگی‌هایی می‌شود که به صورت شرطی فعال هستند، مانند LIVE_ON_GOOGLE_STATUS_ACTIVE_OUTSIDE_DSA_REGION.

فیلد matchStatus می‌تواند برای فیلتر کردن لیست HotelViewهای برگردانده شده برای حساب کاربری استفاده شود.

نمونه‌هایی از شرایط معتبر و نحو آنها به شرح زیر است:

  • 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 .