Release Notes

La version 3 de l'API Travel Partner vous offre un accès programmatique aux éléments suivants:

• Gérer les associations de comptes entre Hotel Center et Google Ads
• Gestion des paramètres d'hôtel sélectionnés
• Gestion des marques et des icônes (version bêta fermée)
• Données sur les performances des propriétés via le service d'affichages des rapports sur les performances des propriétés
• Données relatives aux hôtels via le service Hotel Views
• Données du rapport de participation via le service de participation aux vues de rapports
• Données sur la précision des prix via le service de précision des prix des vues
• Données sur la couverture des prix via le service de couverture des prix
• Données de séjour et tarifs via le service Price Views
• Gestion des rapports de rapprochement des commissions via le service de rapports de rapprochement (partenaires de paiement par séjour pour la commission uniquement)

Points de terminaison

Les points de terminaison de l'API Travel Partner sont accessibles via une syntaxe REST à partir d'appels HTTPS. L'URL de base pour toutes les requêtes est la suivante:

https://travelpartner.googleapis.com

Points de terminaison d'un service
Associations de comptes	Gérer les associations entre un compte Google Ads et un compte 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
Marques	Modifier la configuration de la marque (version bêta fermée) POST /v3/accounts/account id/brands GET /v3/accounts/account id/brands PATCH /v3/accounts/account id/brands/brand id
Hôtels	Modifiez les paramètres d'hôtel sélectionnés. POST /v3/accounts/account id/hotels:setLiveOnGoogle
Vues de l'hôtel	Affiche la liste des vues d'hôtel ou un résumé. GET /v3/accounts/account id/hotelViews GET /v3/accounts/account id/hotelViews:summarize
Icônes	Gérer les icônes (version bêta fermée) POST /v3/accounts/account id/icons GET /v3/accounts/account id/icons/icon id
Consultations du rapport de participation	Renvoie une vue de rapport de participation ou, à l'aide d'une requête, renvoie un sous-ensemble filtré des données de la vue. GET /v3/accounts/account id/participationReportViews GET /v3/accounts/account id/participationReportViews:query
Vues avec précision des prix	Affiche une vue précise de la précision des prix, des vues de précision disponibles ou un résumé. GET /v3/accounts/account id/priceAccuracyViews/report date GET /v3/accounts/account id/priceAccuracyViews GET /v3/accounts/account id/priceAccuracyViews:summarize
Couverture des prix	Renvoie la dernière vue de la couverture des prix ou l'intégralité de l'historique de la couverture. GET /v3/accounts/account id/priceCoverageViews:latest GET /v3/accounts/account id/priceCoverageViews
Vues du prix	Affiche la vue des prix détaillée. GET /v3/accounts/account id/priceViews/partner hotel id
Vues du rapport sur les performances des propriétés	Affiche une vue de rapport sur les performances de la propriété à l'aide d'une requête. GET /v3/accounts/account id/participationReportViews:query
Rapports de rapprochement	Crée, valide et récupère les rapports de rapprochement des commissions (Hotel Ads uniquement). 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

Vous le trouverez dans la section Account Info (Informations sur le compte) de l'onglet Account (Compte) dans Hotel Ads Center.

Journal des modifications

De nombreux services de l'API Travel Partner version 2.1 ont été migrés vers l'API Google Ads. Par conséquent, l'API Travel Partner v3 ne conserve que les services propres aux hôtels.

HotelViewService

• HotelViewService.ListHotelViews (anciennement API Hotels)
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/hotels à https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews.
  • Suppression du paramètre de requête type.
  • Le champ manifestOnly a été supprimé de la réponse.
  • Certains champs ont été renommés.
• HotelViewService.SummarizeHotelViews (anciennement hotel_list_stats dans l'API Scorecard)
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats à https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize.
  • Certains champs ont été renommés.

ParticipationReportViewService (anciennement opportunité_stats dans l'API Scorecard)

• ParticipationReportService.QueryParticipationReport
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats à https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query.
  • Les paramètres de requête ont été ajoutés.
  • Les champs ont été renommés et restructurés.

PriceAccuracyViewService (anciennement price_accuracy report API)

• PriceAccuracyViewService.ListPriceAccuracyViews
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy à https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
  • La nouvelle API renvoie une liste de noms de ressources Hotel View, contrairement à la version précédente, qui renvoie une liste de dates de rapport.
• PriceAccuracyViewService.ListPriceAccuracyViews
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 à https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909.
  • La sortie CSV n'est plus acceptée.
  • Certains champs ont été renommés.

PriceCoverageViewService

• PriceAccuracyViewService.ListPriceCoverageViews (anciennement price_coverage_stats_history dans l'API Scorecard)
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history à https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews.
  • Certains champs ont été renommés.
• PriceAccuracyViewService.GetLatestPriceCoverageViews (anciennement price_coverage_stats dans l'API Scorecard)
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats à https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest.
  • Certains champs ont été renommés.

PriceViewService (anciennement Price API)

• PriceViewService.GetPriceView
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id à https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id.
  • Certains champs ont été renommés.
  • Les informations sur les enchères ont été supprimées de la réponse.

Méthodes ReconciliationReportService (anciennement API Reconciliation Reports)

• ReconciliationReportService.ListReconciliationReports
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports à https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
• ReconciliationReportService.GetReconciliationReport
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename à https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename.
• ReconciliationReportService.CreateReconciliationReport
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports à https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
• ReconciliationReportService.ValidateReconciliationReport
  • Le point de terminaison de l'API est passé de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate à https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.

Obsolescence

Obsolète

indique que la version de l'API continue de fonctionner comme prévu, mais qu'elle ne peut pas être mise à jour avec de nouvelles fonctionnalités ou des corrections de bugs. En outre, lorsqu'une version est obsolète, une date d'abandon est déterminée.

Coucher de soleil

indique que la version de l'API a été supprimée et n'est plus disponible. Le délai minimal entre l'abandon et l'abandon est de trois mois.

Le tableau suivant indique le calendrier actuel des versions d'API, ainsi que les dates d'abandon et d'abandon prévues:

Version	Date d'abandon	Abandon
v3.0	Non disponible	Non disponible
v2.1	Septembre 2019	31 mai 2020
v2.0 (API Bids)	Février 2018	Mai 2018
v2.0 (toutes les autres API)	Septembre 2019	15 février 2020
v1.2	Février 2018	Mai 2018
v1.1	Juin 2016	octobre 2016
v1.0	Avril 2015	octobre 2015

Authentification

Pour accéder à l'API Travel Partner, les clients doivent s'authentifier à l'aide de l'authentification OAuth2.

Pour obtenir un exemple d'application et des informations supplémentaires sur l'utilisation du protocole OAuth pour se connecter à l'API Travel Partner, consultez Authentification de l'API.