Diese Seite wurde von der Cloud Translation API übersetzt.

Release Notes

Version 3 der Travel Partner API bietet programmatischen Zugriff auf:

Kontoverknüpfungen zwischen dem Hotel Center und Google Ads verwalten
Ausgewählte Hoteleinstellungen verwalten
Verwaltung von Marken und Symbolen (geschlossene Betaversion)
Daten zur Property-Leistung über den Bericht „Property-Leistungsbericht“
Hoteldaten über den Hotel View Service
Teilnahmeberichtsdaten über den Dienst für Aufrufe von Berichten zur Teilnahme
Preisgenauigkeitsdaten über den Dienst „Preisgenauigkeitsquoten“
Daten zur Preisabdeckung über den Dienst zur Preisabdeckung
Reise- und Preisdaten über den Dienst „Preisaufrufe“
Verwaltung von Berichten zum Provisionsabgleich über den Abgleichsbericht

Endpunkte

Auf die Travel Partner API-Endpunkte kann über REST-ful-Syntax von HTTPS-Aufrufen zugegriffen werden. Die Basis-URL für alle Anfragen lautet:

https://travelpartner.googleapis.com

Dienstendpunkte
Kontoverknüpfungen	Verwaltet Verknüpfungen zwischen einem Google Ads-Konto und einem Hotel Center-Konto. `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`
Marken	Markenkonfiguration ändern. (geschlossene Betaversion) `POST /v3/accounts/account id/brands GET /v3/accounts/account id/brands PATCH /v3/accounts/account id/brands/brand id`
Hotels	Ausgewählte Hoteleinstellungen ändern. `POST /v3/accounts/account id/hotels:setLiveOnGoogle`
Hotelblick	Gibt die Liste der Hotelansichten oder eine Zusammenfassung zurück. `GET /v3/accounts/account id/hotelViews GET /v3/accounts/account id/hotelViews:summarize`
Symbole	Symbole verwalten. (geschlossene Betaversion) `POST /v3/accounts/account id/icons GET /v3/accounts/account id/icons/icon id`
Teilnahmebericht-Aufrufe	Gibt eine Teilnehmerberichtansicht oder anhand einer Abfrage eine gefilterte Teilmenge der Ansichtsdaten zurück. `GET /v3/accounts/account id/participationReportViews GET /v3/accounts/account id/participationReportViews:query`
Aufrufe der Preisgenauigkeit	Gibt eine bestimmte Preisgenauigkeitsansicht, verfügbare Genauigkeitsansichten oder eine Zusammenfassung zurück. `GET /v3/accounts/account id/priceAccuracyViews/report date GET /v3/accounts/account id/priceAccuracyViews GET /v3/accounts/account id/priceAccuracyViews:summarize`
Aufrufe der Preisabdeckung	Gibt die letzte Ansicht zur Preisabdeckung oder den gesamten Verlauf der Abdeckung zurück. `GET /v3/accounts/account id/priceCoverageViews:latest GET /v3/accounts/account id/priceCoverageViews`
Preisaufrufe	Gibt die angeforderte Preisansicht vollständig zurück. `GET /v3/accounts/account id/priceViews/partner hotel id`
Bericht zu Property-Leistungsberichten	Gibt eine Ansicht des Leistungsberichts einer Property mithilfe einer Abfrage zurück. `GET /v3/accounts/account id/participationReportViews:query`
Abgleichsberichte	Erstellt, validiert und ruft Berichte zum Provisionsabgleich ab (nur Hotelanzeigen) `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`

Ihre Konto-ID finden Sie im Hotel Ads Center auf dem Tab Konto in der Ansicht Kontoinformationen.

Änderungsprotokoll

Viele Dienste der Travel Partner API Version 2.1 wurden zur Google Ads API migriert. Daher werden bei der Travel Partner API Version 3 nur Hoteldienste beibehalten.

HotelViewService

HotelViewService.ListHotelViews (früher Hotels API)
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/hotels zu https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews geändert.
- Der Anfrageparameter type wurde entfernt.
- Das Feld manifestOnly wurde in der Antwort entfernt.
- Einige Felder wurden umbenannt.
HotelViewService.SummarizeHotelViews (früher hotel_list_stats in der Scorecard API)
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats zu https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize geändert.
- Einige Felder wurden umbenannt.

ParticipationReportViewService (früher „Opportunity_stats“ in der Scorecard API)

ParticipationReportService.QueryParticipationReport
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats zu https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query geändert.
- Abfrageparameter wurden hinzugefügt.
- Felder wurden umbenannt und umstrukturiert.

PriceAccuracyViewService (früher price_accuracy Report API)

PriceAccuracyViewService.ListPriceAccuracyViews
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy zu https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews geändert.
- Die neue API gibt eine Liste mit Namen von Hotelansichtsressourcen zurück, im Gegensatz zur vorherigen Version, bei der eine Liste mit Berichtsdaten zurückgegeben wird.
PriceAccuracyViewService.ListPriceAccuracyViews
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 zu https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909 geändert.
- Die CSV-Ausgabe wird nicht mehr unterstützt.
- Einige Felder wurden umbenannt.

PriceAbdeckungViewService

PriceAccuracyViewService.ListPriceCoverageViews (früher price_coverage_stats_history in der Scorecard API)
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history zu https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews geändert.
- Einige Felder wurden umbenannt.
PriceAccuracyViewService.GetLatestPriceCoverageViews (früher price_coverage_stats in der Scorecard API)
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats zu https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest geändert.
- Einige Felder wurden umbenannt.

PriceViewService (früher Preise API)

PriceViewService.GetPriceView
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id zu https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id geändert.
- Einige Felder wurden umbenannt.
- Die Gebotsinformationen wurden aus der Antwort entfernt.

AbgleichReportService-Methoden (früher Abstimmung Reports API)

ReconciliationReportService.ListReconciliationReports
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports zu https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports geändert.
ReconciliationReportService.GetReconciliationReport
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename zu https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename geändert.
ReconciliationReportService.CreateReconciliationReport
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports zu https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports geändert.
ReconciliationReportService.ValidateReconciliationReport
- API-Endpunkt wurde von https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate zu https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate geändert.

Einstellung

Eingestellt: gibt an, dass die API-Version weiterhin wie erwartet funktioniert, aber nicht mit neuen Funktionen oder Fehlerkorrekturen aktualisiert wird. Wenn eine Version eingestellt wird, wird außerdem ein Ablaufdatum festgelegt.
Niedergang: gibt an, dass die API-Version entfernt wurde und nicht mehr verfügbar ist. Die Zeitspanne zwischen der Einstellung und dem Ablauf des Programms beträgt mindestens 3 Monate.

Die folgende Tabelle zeigt den aktuellen Zeitplan der API-Versionen sowie die zu erwartenden Einstellungs- und Einstellungszeit:

Version	Einstellungsdatum	Ablaufdatum
Version 3.0	–	–
V2.1	September 2019	31. Mai 2020
Version 2.0 (Bids API)	Februar 2018	Mai 2018
v2.0 (alle anderen APIs)	September 2019	15. Februar 2020
v1.2	Februar 2018	Mai 2018
v1.1	Juni 2016	Oktober 2016
Version 1.0	April 2015	Oktober 2015

Authentifizierung

Für den Zugriff auf die Travel Partner API müssen sich Kunden mit der OAuth2-Authentifizierung authentifizieren.

Eine Beispielanwendung und zusätzliche Informationen zur Verwendung von OAuth für die Verbindung zur Travel Partner API finden Sie unter API-Authentifizierung.