La version 3 de l'API Travel Partner vous permet d'accéder de manière programmatique aux éléments suivants :
- Gérer les associations de comptes entre Hotel Center et Google Ads
- Gérer les 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 établissements via le service de vues du rapport sur les performances des établissements
- Données sur les hôtels via le service Hotel Views
- Données du rapport sur les participations via le service de vues du rapport sur les participations
- Données sur la précision des prix via le service Price Accuracy Views
- Données de couverture des prix via le service de vues de couverture des prix
- Données sur les itinéraires et les tarifs via le service Price Views
- Gestion des rapports de rapprochement des commissions via le service de rapports de rapprochement (partenaires de type "Commissions (par séjour)" uniquement)
Points de terminaison
Les points de terminaison de l'API Travel Partner sont accessibles via la syntaxe RESTful à 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 | |
|---|---|
| Association de comptes | Gère les associations entre un compte Google Ads et un compte Hotel Center.
|
| Marques | Modifiez la configuration de la marque. (bêta fermée)
|
| Hôtels | Modifiez les paramètres d'hôtel sélectionnés.
|
| Vues d'hôtel | Renvoie la liste des vues d'hôtel ou un récapitulatif.
|
| Icônes | Gérer les icônes. (bêta fermée)
|
| Vues du rapport sur la participation | Renvoie une vue du rapport sur la participation ou, à l'aide d'une requête, renvoie un sous-ensemble filtré des données de la vue.
|
| Vues de précision des prix | Affiche une vue spécifique sur la précision des prix, les vues disponibles sur la précision ou un récapitulatif.
|
| Vues de la couverture des prix | Renvoie la dernière vue de couverture des prix ou l'historique complet de la couverture.
|
| Vues du prix | Renvoie la vue des prix demandée dans le détail.
|
| Vues du rapport sur les performances des propriétés | Renvoie une vue du rapport sur les performances d'une propriété à l'aide d'une requête.
|
| Rapports de rapprochement | Crée, valide et récupère les rapports de rapprochement des commissions (annonces d'hôtels uniquement).
|
Vous trouverez l'ID de votre compte dans la vue Informations sur le compte de l'onglet Compte dans Hotel Ads Center.
Journal des modifications
De nombreux services de l'API Travel Partner v2.1 ont été migrés vers l'API Google Ads. Par conséquent, l'API Travel Partner v3 ne conserve que les services spécifiques aux hôtels.
HotelViewService
HotelViewService.ListHotelViews(anciennement l'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. - Suppression du champ
manifestOnlydans la réponse. - Certains champs ont été renommés.
- Le point de terminaison de l'API est passé de
HotelViewService.SummarizeHotelViews(anciennementhotel_list_statsdans 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.
- Le point de terminaison de l'API est passé de
ParticipationReportViewService (anciennement opportunity_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. - Des paramètres de requête ont été ajoutés.
- Les champs ont été renommés et restructurés.
- Le point de terminaison de l'API est passé de
PriceAccuracyViewService (anciennement l'API de rapport price_accuracy)
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 de vues d'hôtel, contrairement à la version précédente qui renvoyait une liste de dates de rapports.
- Le point de terminaison de l'API est passé de
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 au format CSV n'est plus disponible.
- Certains champs ont été renommés.
- Le point de terminaison de l'API est passé de
PriceCoverageViewService
PriceAccuracyViewService.ListPriceCoverageViews(anciennementprice_coverage_stats_historydans 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.
- Le point de terminaison de l'API est passé de
PriceAccuracyViewService.GetLatestPriceCoverageViews(anciennementprice_coverage_statsdans 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.
- Le point de terminaison de l'API est passé de
PriceViewService (anciennement l'API Prices)
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.
- Le point de terminaison de l'API est passé de
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.
- Le point de terminaison de l'API est passé de
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.
- Le point de terminaison de l'API est passé de
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.
- Le point de terminaison de l'API est passé de
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.
- Le point de terminaison de l'API est passé de
Obsolescence
- Obsolète
- indique que la version de l'API continuera de fonctionner comme prévu, mais il est possible qu'elle ne soit plus mise à jour ou que les bugs ne soient plus corrigés. De plus, lorsqu'une version est obsolète, une date d'arrêt définitif est déterminée.
- Arrêtée
- indique que la version de l'API a été supprimée et qu'elle n'est plus disponible. L'intervalle minimal entre l'abandon et l'arrêt est de trois mois.
Le tableau suivant indique le calendrier actuel des versions de l'API, ainsi que les dates d'obsolescence et d'arrêt prévues :
| Version | Date d'abandon | Date d'arrêt |
|---|---|---|
| v3.0 | N/A | N/A |
| 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 d'OAuth pour se connecter à l'API Travel Partner, consultez Authentification de l'API.