Method: accounts.hotelViews.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Otel görünümlerinin listesini döndürür.
HTTP isteği
GET https://travelpartner.googleapis.com/v3/{parent=accounts/*}/hotelViews
URL, gTB Kod Geçişi söz dizimini kullanır.
Yol parametreleri
| Parametreler |
parent |
string
Sorgulanan hesabın kaynak adı. Biçim accounts/{account_id}.
|
Sorgu parametreleri
| Parametreler |
pageSize |
integer
Tek bir sayfada alınacak öğe sayısı.
|
pageToken |
string
Alınacak sayfanın jetonu.
|
filter |
string
İsteğe bağlı. HotelView'ları filtrelemek için kullanılan koşullar (alanlar ve ifadeler). Söz dizimi için in operatörünün etrafında boşluklar eklenmesi gerekir. Aksi takdirde, boşluklar atlanabilir. Koşullar birleştirilemiyor. hotelId alanı, belirli otelleri seçmek için kullanılabilir.
liveOnGoogle alanı, Google'ın gösterdiği veya Google arama sonuçlarında çıkarılan özellikleri seçebilir.
matchStatus alanı, hesap için döndürülen HotelViews listesini filtrelemek için kullanılabilir.
Geçerli koşul örnekleri ve söz dizimi şöyledir:
hotelId = 'hotel_ABC'hotelId in ('hotel_ABC', 'hotel_XYZ')liveOnGoogle = 'TRUE'liveOnGoogle = 'FALSE'matchStatus = 'NOT_MATCHED'matchStatus in ('NOT_MATCHED', 'MATCHED', 'MAP_OVERLAP')
|
İstek metni
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"hotelViews": [
{
object (HotelView)
}
],
"nextPageToken": string
} |
| Alanlar |
hotelViews[] |
object (HotelView)
Sorguyla eşleşen satırların listesi.
|
nextPageToken |
string
Sonraki sonuç sayfasını almak için kullanılan sayfalara ayırma jetonu.
|
Yetkilendirme Kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/travelpartner
Daha fazla bilgi için OAuth 2.0'a Genel Bakış konusuna bakın.
Tüm hakları saklıdır. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2022-08-23 UTC.
[null,null,["Son güncelleme tarihi: 2022-08-23 UTC."],[[["\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)."]]
