Method: accounts.hotelViews.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muestra la lista de vistas del hotel.
Solicitud HTTP
GET https://travelpartner.googleapis.com/v3/{parent=accounts/*}/hotelViews
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
parent |
string
El nombre de recurso de la cuenta que se consulta. El formato es accounts/{account_id}.
|
Parámetros de consulta
| Parámetros |
pageSize |
integer
Cantidad de elementos para recuperar en una sola página.
|
pageToken |
string
El token de la página que se recuperará.
|
filter |
string
Opcional. Las condiciones (campos y expresiones) que se usan para filtrar HotelViews. La sintaxis requiere espacios alrededor del operador in. De lo contrario, se pueden omitir los espacios. No se pueden unir las condiciones. El campo hotelId se puede usar para seleccionar hoteles específicos. El campo liveOnGoogle puede seleccionar las propiedades que muestra Google o las que se omiten en los resultados de la Búsqueda de Google. El campo matchStatus se puede usar para filtrar la lista de HotelViews que se muestra para la cuenta. Estos son algunos ejemplos de condiciones válidas y su sintaxis:
hotelId = 'hotel_ABC'hotelId in ('hotel_ABC', 'hotel_XYZ')liveOnGoogle = 'TRUE'liveOnGoogle = 'FALSE'matchStatus = 'NOT_MATCHED'matchStatus in ('NOT_MATCHED', 'MATCHED', 'MAP_OVERLAP')
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene datos con la siguiente estructura:
| Representación JSON |
{
"hotelViews": [
{
object (HotelView)
}
],
"nextPageToken": string
} |
| Campos |
hotelViews[] |
object (HotelView)
La lista de filas que coinciden con la consulta.
|
nextPageToken |
string
Token de paginación que se usa para recuperar la siguiente página de resultados.
|
Alcances de la autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/travelpartner
Para obtener más información, consulta la Descripción general de OAuth 2.0.
Todos los derechos reservados. Java es una marca comercial de Oracle o sus afiliados.
Última actualización: 2022-08-23 (UTC)
[null,null,["Última actualización: 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)."]]
