Usage

Auf dieser Seite finden Sie einige Beispielaufrufe mit der Travel Partner API Version 3.

Die Travel Partner API-Endpunkte verwenden REST-konforme Syntax über HTTPS-Aufrufe. base_url für alle API-Anfragen:

https://travelpartner.googleapis.com/v3/accounts/account_id

Eine vollständige Liste der Anfrage- und Antwortfelder finden Sie im API-Ressourcenkatalog.

Leistungsbericht zu Properties

Mit dem Bericht zur Ansicht „Property-Leistungsbericht“ können Sie einen Bericht „Property-Leistungsberichte“ für ein bestimmtes Konto abrufen, filtern und segmentieren.

Leistungsbericht zu Properties abrufen

Im folgenden Beispiel wird der Leistungsbericht für alle Properties im Konto 12345678 abgerufen. Er wird 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 von ihnen für ein bestimmtes Konto.

Liste von Hotels 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 für die Navigation durch mehrseitige Ergebnisse:

GET base_url/hotelviews?pageSize=10&pageToken=11

Zusammenfassung der Eigenschaften 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 Dienst zur Ansicht von Berichten zur Teilnahme haben Sie die Möglichkeit, einen Teilnahmebericht für ein bestimmtes Konto abzurufen, zu filtern und zu segmentieren.

Teilnahmebericht abfragen

Im folgenden Beispiel wird der Teilnahmebericht für alle Properties im Konto 12345678 abgerufen und mit einem Datum vom 4.10.2020 gefiltert.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27

Preisgenauigkeit

Über den Dienst für Aufrufe der Preisgenauigkeit können Preisgenauigkeitsberichte und Kurzübersichten für ein bestimmtes Konto abgerufen werden.

Bericht zur Preisgenauigkeit abrufen

Im folgenden Beispiel wird der Preisgenauigkeitsbericht 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 Durchblättern der Antwort gibt es einige weitere Möglichkeiten, übereinstimmende Preise oder Pixelsignale in die Ergebnisse aufzunehmen.

In diesem Beispiel enthält der Preisgenauigkeitsbericht vom 26.08.2019 übereinstimmende Preise und Pixelsignale:

GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true

Verfügbare Preisgenauigkeitsberichte auflisten

Senden Sie diese Anfrage, um eine Liste der verfügbaren Berichte zu erhalten:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews

Sie können die üblichen Abfrageparameter für das Durchblättern der Ergebnisse angeben.

Preisgenauigkeitsquote abrufen

Verwenden Sie die Methode summarize, um die Kurzübersicht der Preisgenauigkeit zu erhalten:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize

Preisabdeckung

Der Dienst zur Preisabdeckung bietet den aktuellen Bericht zur Preisabdeckung oder den gesamten Verlauf der Preisabdeckung.

Aktuelle Preisabdeckungsstatistiken abrufen

Im folgenden Beispiel werden die neuesten Statistiken zur Preisabdeckung für das Konto 12345678 abgerufen:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest

Verlauf der Preisabdeckung abrufen

Durch diese Anfrage wird der gesamte Verlauf der Preisabdeckung für ein Konto abgerufen:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews

Preis

Mit dem Preisansichtsdienst können Sie einen Preisbericht für eine bestimmte Unterkunft abrufen.

Preisdaten für eine Unterkunft abrufen

Um den Preisbericht für ein bestimmtes Hotel (ID=101) abzurufen, das zum Konto 12345678 gehört, geben Sie diese Anfrage aus:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101

Abgleichsberichte

Abgleichsbericht

Liste der Abgleichsberichte abrufen

Im folgenden Beispiel wird eine Liste der Berichte für das Konto 12345678 abgerufen:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports

Sie können optionale Suchparameter für das Start- und Enddatum angeben, um die Ergebnisse einzuschränken. Die folgende Abfrage beschränkt z. B. nur Berichte zwischen dem 15.06.2019 und dem 15.09.2019:

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 vor dem Hochladen validieren. Wenn Sie einen Bericht validieren, wird er nicht hochgeladen.

Der Abgleichsbericht ist als Text im Feld contents im Text der Anfrage 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

Wenn Sie bestätigt haben, dass ein Abgleichsbericht gültig ist, können Sie ihn wie in diesem Beispiel bei Google hochladen:

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports