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
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
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
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
Beispielantwort
{
"contents": "Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel PostalCode,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency to Billing Currency Conversion Rate,Payment Date,Payment Status\n\n111,\"Capybara Hotel and Spa\",123 Foo Driveway,Boston,MA,02472,US,+11234567890,2thHRTY,2016-01-04,2016-02-01,2016-02-03,1,4,213.88,USD,1,Stayed,21.39,USD,1.0,2016-06-07,Invoice Required\n\n211,\"Mabels Gabels\",45678 Bar Street,London,,KT13 0PU,GB,+440203456123,z452121A,2016-02-04,2016-02-01,2016-02-03,1,3,414.21,GBP,1.249,Stayed,64.43,USD,1.0,2016-06-07,Invoice Required\n\n311,\"No-Tell Motels\",66 Acacia Avenue,Geneva,,1211,CH,+412241820000,42,2016-03-04,2016-02-01,2016-02-03,1,2,451.15,CHF,1.05,Stayed,37.41,EUR,0.99889,2016-06-07,Invoice Required"
}
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
Beispiel für eine erfolgreiche Antwort
{
"successfulRecordCount": 3
}
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
Alle Rechte vorbehalten. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2022-08-23 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2022-08-23 (UTC)."],[[["The Travel Partner API uses REST-ful syntax for HTTPS calls to various endpoints, allowing access to data like property performance, hotel details, and price accuracy."],["You can query reports, like the Property Performance Report or the Participation Report, to gain insights into your hotel data using specific filters and aggregations."],["The API provides methods for retrieving hotel lists, summaries, price coverage information, and pricing data for individual properties within your account."],["Reconciliation Reports, specifically for Hotel Ads, can be listed, downloaded, validated, and uploaded through dedicated API endpoints."],["The base URL for all API requests is `https://travelpartner.googleapis.com/v3/accounts/account_id`, and detailed documentation for resources is available in the API resources catalog."]]],[]]
