Usage

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