Usage

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