Travel Partner API

Die Travel Partner API bietet Ihnen eine RESTful-Schnittstelle zur Google Hotel Center-Plattform. Damit können Daten aus dem Hotel Center effizient abgerufen und geändert werden. Die API eignet sich daher für die Verwaltung großer oder komplexer Konten.

Dienst: travelpartner.googleapis.com

Wir empfehlen, diesen Dienst mit den von Google bereitgestellten Clientbibliotheken aufzurufen. Wenn Ihre Anwendung diesen Dienst mit Ihren eigenen Bibliotheken aufrufen muss, sollten Sie die folgenden Informationen verwenden, wenn Sie die API-Anfragen senden.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Der Dienst bietet das folgende Discovery-Dokument:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://travelpartner.googleapis.com

REST-Ressource: v3.accounts.brands

Methoden
create POST /v3/{parent=accounts/*}/brands
Erstellt eine neue Marke.
get GET /v3/{name=accounts/*/brands/*}
Gibt die Brand-Instanz zurück, die mit dem Markennamen der Anfrage-URI verknüpft ist.
list GET /v3/{parent=accounts/*}/brands
Gibt die Marken für ein Partnerkonto zurück.
patch PATCH /v3/{brand.name=accounts/*/brands/*}
Aktualisiert eine Marke.

REST-Ressource: v3.accounts.freeBookingLinksReportViews

Methoden
query
(deprecated)		 GET /v3/{name=accounts/*}/freeBookingLinksReportViews:query
EINGESTELLT:Verwenden Sie stattdessen PropertyPerformanceReportService.QueryPropertyPerformanceReport, das auch Berichte zu Impressionen enthält.

REST-Ressource: v3.accounts.hotelViews

Methoden
list GET /v3/{parent=accounts/*}/hotelViews
Gibt die Liste der Hotelansichten zurück.
summarize GET /v3/{parent=accounts/*}/hotelViews:summarize
Gibt zusammengefasste Informationen zu Hotels zurück.

REST-Ressource: v3.accounts.hotels

Methoden
setLiveOnGoogle POST /v3/{account=accounts/*}/hotels:setLiveOnGoogle
Benutzerdefinierte Methode auf Sammlungsebene zum Aktualisieren des Status „Live auf Google“ für mehrere Unterkünfte.

REST-Ressource: v3.accounts.icons

Methoden
create POST /v3/{parent=accounts/*}/icons
Lädt ein neues Symbol hoch und startet den Überprüfungsprozess.
get GET /v3/{name=accounts/*/icons/*}
Gibt die Icon-Instanz zurück, die einem im Anfrage-URI angegebenen Symbolressourcennamen zugeordnet ist.
list GET /v3/{parent=accounts/*}/icons
Gibt die Icons für ein Partnerkonto zurück.

REST-Ressource: v3.accounts.listings

Methoden
verify POST /v3/{parent=accounts/*}/listings:verify
Gibt nur bestätigte Einträge mit Datenproblemen und Berechtigungen für die Auslieferung für VR-Partner zurück.

REST-Ressource: v3.accounts.participationReportViews

Methoden
query GET /v3/{name=accounts/*}/participationReportViews:query
Ermöglicht das Abfragen (Abrufen, Filtern und Segmentieren) eines Teilnahmeberichts für ein bestimmtes Konto.

REST-Ressource: v3.accounts.priceAccuracyViews

Methoden
get GET /v3/{name=accounts/*/priceAccuracyViews/*}
Gibt die angeforderte Ansicht zur Preisgenauigkeit mit allen Details zurück.
list GET /v3/{parent=accounts/*}/priceAccuracyViews
Listet die verfügbaren Ansichten für die Preisgenauigkeit auf.
summarize GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize
Gibt die Zusammenfassung der Preisgenauigkeit zurück.

REST-Ressource: v3.accounts.priceCoverageViews

Methoden
getLatest GET /v3/{parent=accounts/*}/priceCoverageViews:latest
Gibt die aktuelle Ansicht der Preisabdeckung mit allen Details zurück.
list GET /v3/{parent=accounts/*}/priceCoverageViews
Gibt den gesamten Verlauf der Preisabdeckung zurück.

REST-Ressource: v3.accounts.priceViews

Methoden
get GET /v3/{name=accounts/*/priceViews/*}
Gibt die angeforderte Preisansicht mit allen Details zurück.

REST-Ressource: v3.accounts.propertyPerformanceReportViews

Methoden
query GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query
Ermöglicht das Abfragen (Abrufen, Filtern und Segmentieren) eines Berichts zu Buchungslinks für ein bestimmtes Konto.

REST-Ressource: v3.accounts.reconciliationReports

Methoden
create POST /v3/{parent=accounts/*}/reconciliationReports
Erstellt einen Abgleichsbericht und lädt ihn zu Google hoch.
get GET /v3/{name=accounts/*/reconciliationReports/*}
Gibt einen Abgleichsbericht zurück.
list GET /v3/{parent=accounts/*}/reconciliationReports
Gibt eine Liste der Namen der erstellten Abgleichsberichte zurück.
validate POST /v3/{parent=accounts/*}/reconciliationReports:validate
Validiert einen Abgleichsbericht.