Method: accounts.hotelViews.list

تعرض هذه السمة قائمة بإطلالات الفندق.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
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.