En esta página, se presentan algunas llamadas de ejemplo con la API de Travel Partner v3.
Los extremos de la API de Travel Partner aceptan sintaxis de RESTful en las llamadas HTTPS. El base_url para todas las solicitudes a la API es el siguiente:
https://travelpartner.googleapis.com/v3/accounts/account_id
Para obtener la lista completa de los campos de solicitud y respuesta, consulta el catálogo de recursos de la API.
Informe de rendimiento de la propiedad
El servicio de vistas del informe de rendimiento de la propiedad permite consultar (obtener, filtrar y segmentar) un informe de rendimiento de la propiedad para una cuenta en particular.
Cómo consultar un informe de rendimiento de la propiedad
En el siguiente ejemplo, se obtiene el informe de rendimiento de la propiedad para todas las propiedades de la cuenta 12345678
, filtrado para la fecha del 11 de mayo de 2022 y agrupado por ID de hotel asociado.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Hoteles
El Servicio de vista de hoteles proporciona una lista de todos los hoteles o un resumen de ellos para una cuenta en particular.
Cómo obtener una lista de hoteles
En el siguiente ejemplo, se recupera una lista de todos los hoteles de la cuenta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews
La solicitud acepta parámetros de consulta para navegar por los resultados de varias páginas:
GET base_url/hotelViews?pageSize=10&pageToken=11
Cómo obtener un resumen de las propiedades
En este ejemplo, se obtiene un resumen de las propiedades de la cuenta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize
Informe de participación
El servicio de vista del informe de participación permite consultar (obtener, filtrar y segmentar) un informe de participación para una cuenta en particular.
Cómo consultar un informe de participación
En el siguiente ejemplo, se obtiene el informe de participación de todas las propiedades de la cuenta 12345678
y se filtra el informe con la fecha del 4/10/20.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27
Precisión del precio
El servicio de vistas de precisión del precio permite recuperar informes y cuadros de evaluación de la precisión del precio para una cuenta en particular.
Cómo obtener un informe de precisión del precio
En el siguiente ejemplo, se recupera el informe de precisión del precio del 26/8/2019 para la cuenta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
Además de los habituales parámetros de consulta para paginar la respuesta, hay algunos más para incluir los precios coincidentes o los indicadores de píxeles en los resultados.
En este ejemplo, el informe de precisión del precio del 26/8/2019 incluye precios coincidentes y señales de píxeles:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Lista de informes de precisión del precio disponibles
Para obtener una lista de los informes disponibles, envía esta solicitud:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
Puedes incluir los parámetros de consulta habituales para paginar los resultados.
Cómo obtener una puntuación de precisión del precio
Para obtener el cuadro de evaluación de la precisión del precio, usa el método summarize
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize
Cobertura de precios
El Servicio de vistas de cobertura de precios proporciona el informe de cobertura de precios más reciente o el historial completo de cobertura de precios.
Cómo obtener las estadísticas de cobertura de precios más recientes
En el siguiente ejemplo, se recuperan las estadísticas de cobertura de precios más recientes para la cuenta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest
Cómo obtener el historial de cobertura de precios
Esta solicitud obtiene todo el historial de cobertura de precios de una cuenta:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews
Precio
El Servicio de vistas de precios te permite recuperar un informe de precios para una propiedad determinada.
Cómo obtener datos de precios para una propiedad
Para obtener el informe de precios de un hotel en particular (ID=101
) que pertenece a la cuenta 12345678
, emite esta solicitud:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101
Informes de conciliación
El servicio de informes de conciliación te permite obtener una lista de informes, descargar uno en particular, validarlo y, luego, subirlo a Google.
Cómo obtener una lista de informes de conciliación
En el siguiente ejemplo, se obtiene una lista de informes para la cuenta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Puedes incluir parámetros de consulta opcionales de fecha de inicio y finalización para limitar los resultados. Por ejemplo, esta consulta limita los informes solo a los que se generaron entre el 15/6/2019 y el 15/9/2019:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Cómo descargar un informe de conciliación
En este ejemplo, se recupera el informe booking_report.csv
(como una respuesta JSON) que se subió en 2019-08-26T12:00:00
:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Cómo validar un informe de conciliación
Puedes usar este método para validar el informe antes de subirlo. La validación de un informe no lo sube.
El informe de conciliación se incluye en el cuerpo de la solicitud, como el valor del campo contents
. El informe de conciliación debe seguir la sintaxis que se describe en Informes de conciliación.
En el siguiente ejemplo, se valida un informe para la cuenta 12345678
:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Cómo subir un informe de conciliación
Después de confirmar que un informe de conciliación es válido, puedes subirlo a Google como en este ejemplo:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports