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.