Travel Partner API

L'API Travel Partner vous fournit une interface RESTful pour la plate-forme Google Hotel Center. Elle permet à une application de récupérer et de modifier efficacement les données Hotel Center. Elle est donc adaptée à la gestion de comptes volumineux ou complexes.

Service : travelpartner.googleapis.com

Pour appeler ce service, nous vous recommandons d'utiliser les bibliothèques clientes fournies par Google. Si votre application doit utiliser vos propres bibliothèques pour appeler ce service, conformez-vous aux informations suivantes lorsque vous effectuez les requêtes API.

Document de découverte

Un document de découverte est une spécification exploitable par un ordinateur qui permet de décrire et de consommer les API REST. Ce document permet de créer des bibliothèques clientes, des plug-ins IDE et d'autres outils qui interagissent avec les API Google. Un même service peut fournir plusieurs documents de découverte. Ce service fournit le document de découverte suivant :

Point de terminaison de service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut posséder plusieurs points de terminaison de service. Ce service possède le point de terminaison de service suivant, et tous les URI ci-dessous sont relatifs à ce point de terminaison de service :

  • https://travelpartner.googleapis.com

Ressource REST : v3.accounts.brands

Méthodes
create POST /v3/{parent=accounts/*}/brands
Crée une marque.
get GET /v3/{name=accounts/*/brands/*}
Renvoie l'instance Brand associée au nom de ressource de marque de l'URI de la requête.
list GET /v3/{parent=accounts/*}/brands
Renvoie les marques d'un compte partenaire.
patch PATCH /v3/{brand.name=accounts/*/brands/*}
Met à jour une marque.

Ressource REST : v3.accounts.freeBookingLinksReportViews

Méthodes
query
(deprecated)		 GET /v3/{name=accounts/*}/freeBookingLinksReportViews:query
OBSOLÈTE : utilisez plutôt PropertyPerformanceReportService.QueryPropertyPerformanceReport, qui inclut également des rapports sur les impressions.

Ressource REST : v3.accounts.hotelViews

Méthodes
list GET /v3/{parent=accounts/*}/hotelViews
Renvoie la liste des vues d'hôtel.
summarize GET /v3/{parent=accounts/*}/hotelViews:summarize
Renvoie des informations récapitulatives sur les hôtels.

Ressource REST : v3.accounts.hotels

Méthodes
setLiveOnGoogle POST /v3/{account=accounts/*}/hotels:setLiveOnGoogle
Méthode personnalisée au niveau de la collection permettant de modifier l'état "Actuellement sur Google" pour plusieurs établissements.

Ressource REST : v3.accounts.icons

Méthodes
create POST /v3/{parent=accounts/*}/icons
Importe une nouvelle icône et lance son processus d'examen.
get GET /v3/{name=accounts/*/icons/*}
Renvoie l'instance Icon associée à un nom de ressource d'icône spécifié dans l'URI de la requête.
list GET /v3/{parent=accounts/*}/icons
Renvoie les Icon pour un compte partenaire.

Ressource REST : v3.accounts.listings

Méthodes
verify POST /v3/{parent=accounts/*}/listings:verify
Renvoie les fiches validées présentant des problèmes de données et les critères d'éligibilité à la diffusion pour les partenaires VR uniquement.

Ressource REST : v3.accounts.participationReportViews

Méthodes
query GET /v3/{name=accounts/*}/participationReportViews:query
Permet d'interroger (obtenir, filtrer et segmenter) un rapport sur la participation pour un compte spécifique.

Ressource REST : v3.accounts.priceAccuracyViews

Méthodes
get GET /v3/{name=accounts/*/priceAccuracyViews/*}
Renvoie la vue de précision des prix demandée dans le détail.
list GET /v3/{parent=accounts/*}/priceAccuracyViews
Liste les vues disponibles sur la précision des prix.
summarize GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize
Renvoie le récapitulatif de la précision des prix.

Ressource REST : v3.accounts.priceCoverageViews

Méthodes
getLatest GET /v3/{parent=accounts/*}/priceCoverageViews:latest
Renvoie la dernière vue de couverture des prix dans le détail.
list GET /v3/{parent=accounts/*}/priceCoverageViews
Renvoie l'intégralité de l'historique de couverture des prix.

Ressource REST : v3.accounts.priceViews

Méthodes
get GET /v3/{name=accounts/*/priceViews/*}
Renvoie la vue des prix demandée dans le détail.

Ressource REST : v3.accounts.propertyPerformanceReportViews

Méthodes
query GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query
Permet d'interroger (obtenir, filtrer et segmenter) un rapport sur les liens de réservation gratuits pour un compte spécifique.

Ressource REST : v3.accounts.reconciliationReports

Méthodes
create POST /v3/{parent=accounts/*}/reconciliationReports
Crée un rapport de rapprochement et l'importe dans Google.
get GET /v3/{name=accounts/*/reconciliationReports/*}
Renvoie un rapport de rapprochement.
list GET /v3/{parent=accounts/*}/reconciliationReports
Affiche la liste des noms des rapports de rapprochement créés.
validate POST /v3/{parent=accounts/*}/reconciliationReports:validate
Valide un rapport de rapprochement.