Se usó la API de Cloud Translation para traducir esta página.

Release Notes

La versión 3 de la API de Travel Partner le brinda acceso programático a lo siguiente:

Administración de las vinculaciones de cuentas entre Hotel Center y Google Ads
Administración de la configuración de hoteles seleccionada
Administración de marcas e íconos (versión beta cerrada)
Datos de rendimiento de la propiedad a través del Servicio de vistas del Informe de rendimiento de propiedad
Datos del hotel a través del Servicio de vistas de hoteles
Datos del informe de participación mediante el servicio Vistas de informes de participación
Datos de precisión del precio mediante el servicio de vistas de precisión del precio
Datos de la cobertura de precios mediante el servicio de vistas de cobertura de precios
Datos de itinerarios y precios mediante el servicio de vistas de precios
Administración de informes de conciliación de comisiones a través del servicio de informes de conciliación (solo para socios que pagan por estadía)

Extremos

Se puede acceder a los extremos de la API de Travel Partner mediante la sintaxis de REST completa desde las llamadas HTTPS. La URL base para todas las solicitudes es la siguiente:

https://travelpartner.googleapis.com

Extremos de Service
Vínculos de la cuenta	Administra las vinculaciones entre una cuenta de Google Ads y una cuenta de Hotel Center. `POST /v3/accounts/account id/accountLinks DELETE /v3/accounts/account id/accountLinks/account link id GET /v3/accounts/account id/accountLinks/account link id GET /v3/accounts/account id/accountLinks PATCH /v3/accounts/account id/accountLinks/account link id`
Marcas	Modificar la configuración de la marca. (versión beta cerrada) `POST /v3/accounts/account id/brands GET /v3/accounts/account id/brands PATCH /v3/accounts/account id/brands/brand id`
Hoteles	Modificar la configuración seleccionada del hotel `POST /v3/accounts/account id/hotels:setLiveOnGoogle`
Vistas del hotel	Muestra la lista de vistas del hotel o un resumen. `GET /v3/accounts/account id/hotelViews GET /v3/accounts/account id/hotelViews:summarize`
Íconos	Administrar íconos. (versión beta cerrada) `POST /v3/accounts/account id/icons GET /v3/accounts/account id/icons/icon id`
Vistas del informe de participación	Muestra la vista de un informe de participación o, mediante el uso de una consulta, muestra un subconjunto filtrado de los datos de la vista. `GET /v3/accounts/account id/participationReportViews GET /v3/accounts/account id/participationReportViews:query`
Vistas de precisión del precio	Muestra una vista de precisión del precio en particular, vistas de precisión disponibles o un resumen. `GET /v3/accounts/account id/priceAccuracyViews/report date GET /v3/accounts/account id/priceAccuracyViews GET /v3/accounts/account id/priceAccuracyViews:summarize`
Vistas de cobertura de precios	Muestra la vista de cobertura de precios más reciente o todo el historial de cobertura. `GET /v3/accounts/account id/priceCoverageViews:latest GET /v3/accounts/account id/priceCoverageViews`
Vistas de precios	Muestra la vista de precio solicitada en detalle. `GET /v3/accounts/account id/priceViews/partner hotel id`
Vistas del Informe de rendimiento de propiedad	Muestra una vista de informe de rendimiento de propiedades mediante una consulta. `GET /v3/accounts/account id/participationReportViews:query`
Informes de conciliación	Crea, valida y recupera informes de conciliación de comisiones (solo anuncios de hoteles). `POST /v3/accounts/account id/reconciliationReports POST /v3/accounts/account id/reconciliationReports:validate GET /v3/accounts/account id/reconciliationReports/datetime~filename GET /v3/accounts/account id/reconciliationReports`

Puedes buscar tu ID de cuenta en la vista Información de la cuenta de la pestaña Cuenta en Hotel Ads Center.

Registro de cambios

Muchos servicios de la API de Travel Partner v2.1 se migraron a la API de Google Ads. Como resultado, la API de Travel Partner v3 solo conserva servicios específicos de hoteles.

Servicio de HotelView

HotelViewService.ListHotelViews (anteriormente API de Hotels)
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/hotels a https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews.
- Se quitó el parámetro de solicitud type.
- Se quitó el campo manifestOnly de la respuesta.
- Se cambió el nombre de algunos campos.
HotelViewService.SummarizeHotelViews (anteriormente hotel_list_stats en la API de cuadro de evaluación)
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats a https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize.
- Se cambió el nombre de algunos campos.

ParticipationReportViewService (anteriormente opportunities_stats en la API de cuadro de evaluación)

ParticipationReportService.QueryParticipationReport
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats a https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query.
- Se agregaron los parámetros de búsqueda.
- Los campos se renombraron y reestructuraron.

PriceExactViewService (anteriormente API de informe price_accuracy)

PriceAccuracyViewService.ListPriceAccuracyViews
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy a https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
- La nueva API muestra una lista de nombres de recursos de vista de hoteles en comparación con la versión anterior, que muestra una lista de fechas de informes.
PriceAccuracyViewService.ListPriceAccuracyViews
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 a https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909.
- Ya no se admite el formato de salida CSV.
- Se cambió el nombre de algunos campos.

Servicio de cobertura de precios

PriceAccuracyViewService.ListPriceCoverageViews (anteriormente price_coverage_stats_history en la API de cuadro de evaluación)
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history a https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews.
- Se cambió el nombre de algunos campos.
PriceAccuracyViewService.GetLatestPriceCoverageViews (anteriormente price_coverage_stats en la API de cuadro de evaluación)
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats a https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest.
- Se cambió el nombre de algunos campos.

PriceViewService (anteriormente API de precios)

PriceViewService.GetPriceView
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id a https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id.
- Se cambió el nombre de algunos campos.
- Se quitó información de ofertas de la respuesta.

Métodos ReconciliationReportService (anteriormente API de informes de conciliación)

ReconciliationReportService.ListReconciliationReports
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports a https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
ReconciliationReportService.GetReconciliationReport
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename a https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename.
ReconciliationReportService.CreateReconciliationReport
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports a https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
ReconciliationReportService.ValidateReconciliationReport
- El extremo de la API cambió de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate a https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.

Baja

Obsoleto: indica que la versión de la API seguirá funcionando como se espera, pero es posible que no se actualice con funciones nuevas o correcciones de errores. Además, cuando una versión deja de estar disponible, se determina una fecha de caducidad.
Atardecer: indica que se quitó la versión de la API y ya no está disponible. El tiempo mínimo entre la baja y la puesta de sol es de 3 meses.

En la siguiente tabla, se muestra el programa actual de las versiones de API, así como las fechas de baja y puesta de sol previstas:

Versión	Fecha de baja	Fecha de puesta del sol
Versión 3.0	N/A	N/A
v2.1	Septiembre de 2019	31 de mayo de 2020
v2.0 (API de ofertas)	Febrero de 2018	Mayo de 2018
v2.0 (todas las demás API)	Septiembre de 2019	15 de febrero de 2020
v1.2	Febrero de 2018	Mayo de 2018
v1.1	junio de 2016	octubre de 2016
v1.0	abril de 2015	octubre de 2015

Autenticación

Para acceder a la API de Travel Partner, los clientes deben autenticarse con la autenticación OAuth2.

Si desea ver un ejemplo de aplicación e información adicional sobre el uso de OAuth para conectarse a la API de Travel Partner, consulte Autenticación de API.