Auf dieser Seite finden Sie einige Beispielaufrufe der Travel Partner API v3.
Die Travel Partner API-Endpunkte akzeptieren REST-konforme Syntax in HTTPS-Aufrufen. Die base_url für alle API-Anfragen lautet:
https://travelpartner.googleapis.com/v3/accounts/account_id
Eine vollständige Liste der Anfrage- und Antwortfelder finden Sie im Katalog der API-Ressourcen.
Bericht zur Unterkunftleistung
Mit dem Property Performance Report View Service können Sie einen Leistungsbericht für eine Property für ein bestimmtes Konto abfragen (abrufen, filtern und segmentieren).
Bericht zur Property-Leistung abfragen
Im folgenden Beispiel wird der Leistungsbericht für alle Properties im Konto 12345678
abgerufen. Die Daten sind nach dem 11. Mai 2022 gefiltert und nach Partner-Hotel-ID gruppiert.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Hotels
Der Hotel View Service bietet entweder eine Liste aller Hotels oder eine Zusammenfassung der Hotels für ein bestimmtes Konto.
Hotelliste abrufen
Im folgenden Beispiel wird eine Liste aller Hotels im Konto 12345678
abgerufen:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews
Die Anfrage akzeptiert Abfrageparameter zum Navigieren durch mehrseitige Ergebnisse:
GET base_url/hotelViews?pageSize=10&pageToken=11
Zusammenfassung der Attribute abrufen
In diesem Beispiel wird eine Zusammenfassung der Properties für das Konto 12345678
abgerufen:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize
Teilnahmebericht
Mit dem Participation Report View Service können Sie einen Teilnahmebericht für ein bestimmtes Konto abfragen (abrufen, filtern und segmentieren).
Teilnahmebericht abfragen
Im folgenden Beispiel wird der Teilnahmebericht für alle Properties im Konto 12345678
abgerufen und nach dem Datum 04.10.2020 gefiltert.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27
Preisgenauigkeit
Mit dem Price Accuracy Views Service können Sie Preisrichtigkeitsberichte und ‑scorecards für ein bestimmtes Konto abrufen.
Preisgenauigkeitsbericht erhalten
Im folgenden Beispiel wird der Preisrichtigkeitsbericht vom 26.08.2019 für das Konto 12345678
abgerufen:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
Neben den üblichen Abfrageparametern für das Paging durch die Antwort gibt es noch einige weitere, mit denen Sie übereinstimmende Preise oder Pixelsignale in die Ergebnisse einbeziehen können.
In diesem Beispiel enthält der Preisrichtigkeitsbericht vom 26.08.2019 abgeglichene Preise und Pixelsignale:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Verfügbare Preisgenauigkeitsberichte für Einträge
Wenn Sie eine Liste der verfügbaren Berichte abrufen möchten, senden Sie diese Anfrage:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
Sie können die üblichen Abfrageparameter verwenden, um die Ergebnisse zu paginieren.
Preisgenauigkeitsquote erhalten
Verwenden Sie die Methode summarize
, um die Preisrichtigkeitsübersicht abzurufen:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize
Preisabdeckung
Der Price Coverage Views Service bietet den neuesten Bericht zur Preisabdeckung oder den gesamten Verlauf der Preisabdeckung.
Aktuelle Statistiken zur Preisabdeckung abrufen
Im folgenden Beispiel werden die aktuellen Statistiken zur Preisabdeckung für das Konto 12345678
abgerufen:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest
Verlauf der Preisabdeckung abrufen
Mit dieser Anfrage wird der gesamte Preisabdeckungsverlauf für ein Konto abgerufen:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews
Preis
Mit dem Price Views Service können Sie einen Preisbericht für eine bestimmte Property abrufen.
Preisdaten für eine Unterkunft abrufen
So rufen Sie den Preisbericht für ein bestimmtes Hotel (ID=101
) ab, das zum Konto 12345678
gehört:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101
Abgleichsberichte
Mit dem Reconciliation Reports Service können Sie eine Liste von Berichten abrufen, einen bestimmten Bericht herunterladen, ihn validieren und dann zu Google hochladen.
Liste mit Abgleichsberichten abrufen
Im folgenden Beispiel wird eine Liste von Berichten für das Konto 12345678
abgerufen:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Sie können optionale Abfrageparameter für das Start- und Enddatum einfügen, um die Ergebnisse einzugrenzen. Mit dieser Abfrage werden Berichte beispielsweise auf den Zeitraum vom 15.06.2019 bis zum 15.09.2019 beschränkt:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Abgleichsbericht herunterladen
In diesem Beispiel wird der Bericht booking_report.csv
(als JSON-Antwort) abgerufen, der unter 2019-08-26T12:00:00
hochgeladen wurde:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Abgleichsbericht validieren
Mit dieser Methode können Sie den Bericht validieren, bevor Sie ihn hochladen. Wenn Sie einen Bericht validieren, wird er nicht hochgeladen.
Der Abstimmungsbericht ist im Text der Anfrage als Wert für das Feld contents
enthalten. Der Abgleichsbericht muss der Syntax entsprechen, die unter Abgleichsberichte beschrieben wird.
Im folgenden Beispiel wird ein Bericht für das Konto 12345678
validiert:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Abgleichsbericht hochladen
Nachdem Sie bestätigt haben, dass ein Abgleichsbericht gültig ist, können Sie ihn wie in diesem Beispiel in Google hochladen:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports