Usage

Cette page présente quelques exemples d'appels à l'aide de l'API Travel Partner v3.

Les points de terminaison de l'API Travel Partner acceptent la syntaxe RESTful dans les appels HTTPS. Le base_url pour toutes les requêtes API est le suivant :

https://travelpartner.googleapis.com/v3/accounts/account_id

Pour obtenir la liste complète des champs de requête et de réponse, consultez le catalogue des ressources de l'API.

Rapport sur les performances des établissements

Le service de vue du rapport sur les performances des propriétés permet d'interroger (obtenir, filtrer et segmenter) un rapport sur les performances des propriétés pour un compte spécifique.

Interroger un rapport sur les performances d'une propriété

L'exemple suivant obtient le rapport sur les performances des propriétés pour toutes les propriétés du compte 12345678, filtré à la date du 11 mai 2022 et regroupé par ID d'hôtel partenaire.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId

Hôtels

Le service de vue des hôtels fournit la liste de tous les hôtels ou un récapitulatif de ceux-ci pour un compte donné.

Obtenir une liste d'hôtels

L'exemple suivant récupère la liste de tous les hôtels du compte 12345678 :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews

La requête accepte les paramètres de requête pour parcourir les résultats sur plusieurs pages :

GET base_url/hotelViews?pageSize=10&pageToken=11

Obtenir un récapitulatif des propriétés

Cet exemple obtient un récapitulatif des propriétés du compte 12345678 :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize

Rapport sur les participations

Le service de consultation des rapports sur la participation permet d'interroger (obtenir, filtrer et segmenter) un rapport sur la participation pour un compte spécifique.

Interroger un rapport sur les participations

L'exemple suivant récupère le rapport sur la participation pour toutes les propriétés du compte 12345678 et le filtre en utilisant la date du 04/10/20.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27

Précision du prix

Le service de consultation de la précision des prix permet de récupérer les rapports et les tableaux de données sur la précision des prix pour un compte donné.

Obtenir un rapport sur la précision des prix

L'exemple suivant récupère le rapport sur la précision des prix du 26/08/2019 pour le compte 12345678 :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826

En plus des paramètres de requête habituels pour parcourir la réponse, il en existe d'autres pour inclure les prix correspondants ou les signaux de pixels dans les résultats.

Dans cet exemple, le rapport sur la précision des prix du 26/08/2019 inclut les prix correspondants et les signaux de pixels :

GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true

Lister les rapports disponibles sur la précision des prix

Pour obtenir la liste des rapports disponibles, envoyez la requête suivante :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews

Vous pouvez inclure les paramètres de requête habituels pour parcourir les résultats.

Obtenir un taux de précision des prix

Pour obtenir le tableau de données sur la précision des prix, utilisez la méthode summarize :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize

Couverture des prix

Le service de vues sur la couverture des prix fournit le dernier rapport sur la couverture des prix ou l'historique complet de la couverture des prix.

Obtenir les dernières statistiques sur la couverture des prix

L'exemple suivant récupère les dernières statistiques de couverture des prix pour le compte 12345678 :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest

Obtenir l'historique de la couverture des prix

Cette requête permet d'obtenir l'intégralité de l'historique de couverture des prix pour un compte :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews

Prix

Le service Price Views vous permet de récupérer un rapport sur les prix pour une propriété donnée.

Obtenir les données tarifaires d'un établissement

Pour obtenir le rapport sur les prix d'un hôtel spécifique (ID=101) appartenant au compte 12345678, envoyez la requête suivante :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101

Rapports de rapprochement

Le service de rapports de rapprochement vous permet d'obtenir une liste de rapports, de télécharger un rapport spécifique, de le valider, puis de l'importer dans Google.

Obtenir la liste des rapports de rapprochement

L'exemple suivant permet d'obtenir la liste des rapports pour le compte 12345678 :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports

Vous pouvez inclure des paramètres de requête de date de début et de fin facultatifs pour limiter les résultats. Par exemple, la requête suivante limite les rapports à ceux compris entre le 15/06/2019 et le 15/09/2019 :

GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15

Télécharger un rapport de rapprochement

Cet exemple récupère le rapport booking_report.csv (sous forme de réponse JSON) qui a été importé à 2019-08-26T12:00:00 :

GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv

Valider un rapport de rapprochement

Vous pouvez utiliser cette méthode pour valider le rapport avant de l'importer. Valider un rapport ne l'importe pas.

Le rapport de rapprochement est inclus dans le corps de la requête, en tant que valeur du champ contents. Le rapport de rapprochement doit respecter la syntaxe décrite dans Rapports de rapprochement.

L'exemple suivant valide un rapport pour le compte 12345678 :

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate

Importer un rapport de rapprochement

Une fois que vous avez confirmé la validité d'un rapport de rapprochement, vous pouvez l'importer dans Google, comme dans cet exemple :

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports