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

اختياريّ. الشروط (الحقول والتعبيرات) المستخدَمة لفلترة الفنادق. تتطلّب البنية تثبيت مسافات حول عامل التشغيل 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.