Ta strona zawiera przykładowe wywołania za pomocą interfejsu Travel Partner API v3.
Punkty końcowe interfejsu Partner Partner API używają składni opartej na protokole REST za pomocą wywołań HTTPS. base_url w przypadku wszystkich żądań do interfejsu API wynosi:
Ten przykład obejmuje raport o skuteczności usługi dotyczący wszystkich usług na koncie 12345678, filtrowany według daty 11 maja 2022 r. i pogrupowany według identyfikatora hotelu partnerskiego.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Usługa widoków dokładności cen umożliwia pobieranie raportów o dokładności cen i podsumowań statystyk dla określonego konta.
Generowanie raportu o dokładności cen
Ten przykład pokazuje raport z dokładności ceny 8 sierpnia 2019 r. na koncie 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
Oprócz typowych parametrów zapytania w odpowiedzi na strony istnieje jeszcze kilka innych opcji, które pozwalają uwzględnić dopasowane ceny lub sygnały pikselowe w wynikach.
W tym przykładzie raport z dokładnością cen z 26 sierpnia 2019 r. zawiera dopasowane ceny i sygnały dotyczące pikseli:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Dostępne raporty o dokładności cen
Aby uzyskać listę dostępnych raportów, wyślij tę prośbę:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Aby ograniczyć wyniki, możesz dodać opcjonalne parametry zapytania dotyczące daty rozpoczęcia i zakończenia. Na przykład zapytanie obejmuje tylko raporty z okresu od 15 czerwca 2019 r. do 15 września 2019 r.:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Ten przykład pobiera raport booking_report.csv (jako odpowiedź JSON) przesłany do 2019-08-26T12:00:00:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Przykładowa odpowiedź
{
"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"
}
Weryfikowanie raportu uzgodnień
Możesz użyć tej metody, aby zweryfikować raport przed jego przesłaniem. Weryfikacja raportu nie powoduje jego przesłania.
Raport uzgodnień jest zawarty w treści żądania jako wartość w polu contents. Raport uzgodnień musi być zgodny ze składnią opisaną w artykule Raporty uzgodnień.
Ten przykład weryfikuje raport o koncie 12345678:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Przykładowa odpowiedź
{
"successfulRecordCount": 3
}
Przesyłanie raportu uzgodnień
Gdy potwierdzisz, że raport uzgodnień jest prawidłowy, możesz go przesłać do Google, jak w tym przykładzie:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Wszelkie prawa zastrzeżone. Java jest zastrzeżonym znakiem towarowym firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2022-08-23 UTC.
[null,null,["Ostatnia aktualizacja: 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."]]],[]]