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')
|
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"hotelViews": [
{
object (HotelView)
}
],
"nextPageToken": string
} |
| زمینه های |
|---|
hotelViews[] | object ( HotelView ) لیست ردیف هایی که با پرس و جو مطابقت دارند. |
nextPageToken | string نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/travelpartner
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
کلیه حقوق محفوظ است. Java علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2022-08-23 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2022-08-23 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eRetrieves a list of hotel views associated with a specific account, allowing for filtering and pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequest is made via a GET method to the specified endpoint with required path and optional query parameters.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes an array of hotel views and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/travelpartner\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.hotelViews.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListHotelViewsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns the list of hotel views.\n\n### HTTP request\n\n`GET https://travelpartner.googleapis.com/v3/{parent=accounts/*}/hotelViews`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------|\n| `parent` | `string` The resource name of the account being queried. The format is `accounts/{account_id}`. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Number of elements to retrieve in a single page. |\n| `pageToken` | `string` Token of the page to retrieve. |\n| `filter` | `string` Optional. The conditions (fields and expressions) used to filter HotelViews. The syntax requires spaces surrounding the `in` operator. Otherwise, spaces can be omitted. Conditions cannot be joined. The `hotelId` field can be used to select specific hotels. The `liveOnGoogle` field can select properties that Google shows, or properties that are omitted in google search results. A value of 'TRUE' includes properties that are conditionally active, e.g. LIVE_ON_GOOGLE_STATUS_ACTIVE_OUTSIDE_DSA_REGION. The `matchStatus` field can be used to filter the list of HotelViews returned for the account. Examples of valid conditions and their syntax are as follows: - `hotelId = 'hotel_ABC'` - `hotelId in ('hotel_ABC', 'hotel_XYZ')` - `liveOnGoogle = 'TRUE'` - `liveOnGoogle = 'FALSE'` - `matchStatus = 'NOT_MATCHED'` - `matchStatus in ('NOT_MATCHED', 'MATCHED', 'MAP_OVERLAP')` |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for [HotelViewService.ListHotelViews](/hotels/hotel-prices/api-reference/rest/v3/accounts.hotelViews/list#google.travel.travelpartner.v3.HotelViewService.ListHotelViews).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"hotelViews\": [ { object (/hotels/hotel-prices/api-reference/rest/v3/accounts.hotelViews#HotelView) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `hotelViews[]` | `object (`[HotelView](/hotels/hotel-prices/api-reference/rest/v3/accounts.hotelViews#HotelView)`)` The list of rows that match the query. |\n| `nextPageToken` | `string` Pagination token used to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/travelpartner`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
