Release Notes

Version 3 der Travel Partner API bietet programmatischen Zugriff auf:

  • Verwaltung von Kontoverknüpfungen zwischen Hotel Center und Google Ads
  • Verwaltung ausgewählter Hoteleinstellungen
  • Marken und Symbole verwalten (geschlossene Betaversion)
  • Leistungsdaten von Properties über den Property Performance Report Views Service
  • Hoteldaten über den Hotel Views Service
  • Daten aus Teilnahmeberichten über den Dienst „Participation Report Views“
  • Daten zur Preisgenauigkeit über den Price Accuracy Views Service
  • Daten zur Preisabdeckung über den Price Coverage Views Service
  • Reiseplan- und Preisdaten über den Price Views Service
  • Verwaltung von Provisionsabgleichsberichten über den Reconciliation Reports Service (nur für Partner mit der Gebotsstrategie „Provisionen (Pay-per-Stay)“)

Endpunkte

Die Travel Partner API-Endpunkte sind über REST-Syntax aus HTTPS-Aufrufen zugänglich. Die Basis-URL für alle Anfragen lautet:

https://travelpartner.googleapis.com

Dienstendpunkte
Kontolinks

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

Hotelansichten

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

Aufrufe von Teilnahmeberichten

Gibt eine Ansicht für Teilnahmeberichte oder mithilfe einer Abfrage eine gefilterte Teilmenge der Daten der Ansicht zurück.

GET /v3/accounts/account id/participationReportViews
GET /v3/accounts/account id/participationReportViews:query

Ansichten zur Preisgenauigkeit

Gibt eine bestimmte Ansicht zur Preisgenauigkeit, verfügbare Ansichten zur Preisgenauigkeit 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 aktuelle Ansicht der Preisabdeckung oder den gesamten Abdeckungsverlauf zurück.

GET /v3/accounts/account id/priceCoverageViews:latest
GET /v3/accounts/account id/priceCoverageViews

Preisansichten

Gibt die angeforderte Preisansicht mit allen Details zurück.

GET /v3/accounts/account id/priceViews/partner hotel id

Bericht „Leistung nach Property“ – Aufrufe

Gibt eine Ansicht für einen Leistungsbericht für Properties anhand einer Abfrage zurück.

GET /v3/accounts/account id/participationReportViews:query

Abgleichsberichte

Erstellt, validiert und ruft Abgleichsberichte zu Provisionen 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

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

Änderungsprotokoll

Viele Dienste in der Travel Partner API v2.1 wurden zur Google Ads API migriert. Daher sind in der Travel Partner API v3 nur noch hotelspezifische Dienste enthalten.

HotelViewService

  • HotelViewService.ListHotelViews (früher Hotels API)
    • Der 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 aus der Antwort entfernt.
    • Einige Felder wurden umbenannt.
  • HotelViewService.SummarizeHotelViews (früher hotel_list_stats in der Scorecard API)
    • Der 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
    • Der 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.
    • Es wurden Abfrageparameter hinzugefügt.
    • Felder wurden umbenannt und umstrukturiert.

PriceAccuracyViewService (früher: Price Accuracy Report API)

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • Der 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 Ressourcennamen für Hotelansichten zurück. In der vorherigen Version wurde eine Liste mit Berichtsdatumsangaben zurückgegeben.
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • Der 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.

PriceCoverageViewService

  • PriceAccuracyViewService.ListPriceCoverageViews (früher price_coverage_stats_history in der Scorecard API)
    • Der 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)
    • Der 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 Prices API)

  • PriceViewService.GetPriceView
    • Der 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.
    • Gebotsinformationen aus der Antwort entfernt.

ReconciliationReportService-Methoden (früher Reconciliation Reports API)

  • ReconciliationReportService.ListReconciliationReports
    • Der 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
    • Der 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
    • Der 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
    • Der 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

Eingestellte Funktionen
bedeutet, dass die API-Version weiterhin wie erwartet funktioniert, aber eventuell nicht mit neuen Funktionen oder Fehlerkorrekturen aktualisiert wird. Wenn eine Version eingestellt wird, wird außerdem ein Ablaufdatum festgelegt.
Eingestellt
bedeutet, dass die API-Version entfernt wurde und nicht mehr verfügbar ist. Die Mindestzeit zwischen der Einstellung und der endgültigen Abschaltung beträgt 3 Monate.

In der folgenden Tabelle finden Sie den aktuellen Zeitplan für API-Versionen sowie die erwarteten Datumsangaben für die Einstellung und das Ende der Unterstützung:

Version Einstellungsdatum Datum der Einstellung
v3.0 – –
V2.1 September 2019 31. Mai 2020
v2.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
v1.0 April 2015 Oktober 2015

Authentifizierung

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

Eine Beispielanwendung und weitere Informationen zur Verwendung von OAuth zum Herstellen einer Verbindung zur Travel Partner API finden Sie unter API-Authentifizierung.