Method: accounts.hotelViews.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Affiche la liste des vues d'hôtel.
Requête HTTP
GET https://travelpartner.googleapis.com/v3/{parent=accounts/*}/hotelViews
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
parent |
string
Nom de ressource du compte interrogé. Il a le format suivant : accounts/{account_id}.
|
Paramètres de requête
| Paramètres |
pageSize |
integer
Nombre d'éléments à récupérer sur une seule page.
|
pageToken |
string
Jeton de la page à récupérer.
|
filter |
string
Facultatif. Conditions (champs et expressions) utilisées pour filtrer HotelView. La syntaxe nécessite des espaces autour de l'opérateur in. Sinon, vous pouvez omettre les espaces. Impossible de joindre des conditions. Le champ hotelId permet de sélectionner des hôtels spécifiques. Le champ liveOnGoogle permet de sélectionner les propriétés qui apparaissent dans Google ou qui sont omises dans les résultats de recherche Google. Le champ matchStatus permet de filtrer la liste des HotelViews affichés pour le compte. Voici des exemples de conditions valides et leur syntaxe:
hotelId = 'hotel_ABC'hotelId in ('hotel_ABC', 'hotel_XYZ')liveOnGoogle = 'TRUE'liveOnGoogle = 'FALSE'matchStatus = 'NOT_MATCHED'matchStatus in ('NOT_MATCHED', 'MATCHED', 'MAP_OVERLAP')
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"hotelViews": [
{
object (HotelView)
}
],
"nextPageToken": string
} |
| Champs |
hotelViews[] |
object (HotelView)
Liste de lignes correspondant à la requête.
|
nextPageToken |
string
Jeton de pagination utilisé pour récupérer la page de résultats suivante.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/travelpartner
Pour en savoir plus, consultez Présentation d'OAuth 2.0.
Tous droits réservés. Java est une marque déposée d'Oracle et/ou ses affiliés.
Dernière mise à jour le 2022/08/23 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
