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

Release Notes

La versión 3 de la API de Travel Partner te 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 del hotel seleccionado
Administración de marcas e íconos (beta cerrada)
Datos de rendimiento de la propiedad a través del servicio de vistas del informe de rendimiento de la propiedad
Datos de hoteles a través del servicio de Hotel Views
Datos del informe de participación a través del servicio de vistas del informe de participación
Datos de precisión del precio a través del servicio de Price Accuracy Views
Datos de cobertura de precios a través del servicio de vistas de cobertura de precios
Datos de itinerario y precios a través del servicio Price Views
Administración de informes de conciliación de comisiones a través del servicio de informes de conciliación (solo para socios de pago por estadía con comisiones)

Extremos

Se puede acceder a los extremos de la API de Travel Partner a través de la sintaxis RESTful de las llamadas HTTPS. La URL base para todas las solicitudes es la siguiente:

https://travelpartner.googleapis.com

Extremos del servicio
Vinculación de cuentas	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	Modifica la configuración del hotel seleccionado. `POST /v3/accounts/account id/hotels:setLiveOnGoogle`
Vistas de hoteles	Devuelve la lista de vistas de hoteles 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	Devuelve una vista del informe de participación o, mediante una consulta, devuelve 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	Devuelve una vista de precisión del precio en particular, las 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	Devuelve 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	Devuelve la vista de precios solicitada con todos los detalles. `GET /v3/accounts/account id/priceViews/partner hotel id`
Vistas del informe de rendimiento de la propiedad	Devuelve una vista del informe de rendimiento de la propiedad con una consulta. `GET /v3/accounts/account id/participationReportViews:query`
Informes de conciliación	Crea, valida y recupera informes de conciliación de comisiones (solo para 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 el ID de tu 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 versión 2.1 de la API de Travel Partner se migraron a la API de Google Ads. Como resultado, la versión 3 de la API de Travel Partner solo conserva los servicios específicos para hoteles.

HotelViewService

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 Scorecard)
- 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 opportunity_stats en la API de Scorecard)

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 parámetros de consulta.
- Se cambiaron los nombres y se reestructuraron los campos.

PriceAccuracyViewService (antes API del informe de 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 devuelve una lista de nombres de recursos de vistas de hoteles, a diferencia de la versión anterior, que devolvía 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 admiten los resultados CSV.
- Se cambió el nombre de algunos campos.

PriceCoverageViewService

PriceAccuracyViewService.ListPriceCoverageViews (anteriormente price_coverage_stats_history en la API de Scorecard)
- 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 Scorecard)
- 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 (antes API de Prices)

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ó la información de las ofertas de la respuesta.

Métodos de ReconciliationReportService (anteriormente, API de Reconciliation Reports)

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

Funciones obsoletas: indica que la versión de la API seguirá funcionando según lo previsto, pero es posible que no se actualice con funciones nuevas ni correcciones de errores. Además, cuando se descontinúa una versión, se determina una fecha de desactivación.
Descontinuado: indica que se quitó la versión de la API y que ya no está disponible. El período mínimo entre la baja y el cierre es de 3 meses.

En la siguiente tabla, se muestra el programa actual de versiones de la API, así como las fechas esperadas de baja y descontinuación:

Versión	Fecha de baja	Fecha de desactivación
v3.0	N/A	N/A
v2.1	Septiembre de 2019	31 de mayo de 2020
v2.0 (API de Bids)	Febrero de 2018	Mayo de 2018
v2.0 (todas las demás APIs)	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 de OAuth2.

Para ver un ejemplo de aplicación y obtener información adicional sobre el uso de OAuth para conectarte a la API de Travel Partner, consulta Autenticación de API.

Release Notes Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.