Na tej stronie znajdziesz przykładowe wywołania interfejsu Travel Partner API w wersji 3.
Punkty końcowe interfejsu Travel Partner API akceptują składnię REST w wywołaniach HTTPS. W przypadku wszystkich żądań do interfejsu API base_url to:
https://travelpartner.googleapis.com/v3/accounts/account_id
Pełną listę pól żądań i odpowiedzi znajdziesz w katalogu zasobów interfejsu API.
Raport skuteczności usługi
Usługa wyświetlania raportu skuteczności usługi umożliwia wysyłanie zapytań (pobieranie, filtrowanie i segmentowanie) dotyczących raportu skuteczności usługi na określonym koncie.
Wysyłanie zapytań o raport skuteczności usługi
Poniższy przykład pobiera raport skuteczności usługi dla wszystkich usług na koncie 12345678
, przefiltrowany według daty 11 maja 2022 r. i pogrupowany według identyfikatora hotelu partnera.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Hotele
Usługa widoku hotelu udostępnia listę wszystkich hoteli lub ich podsumowanie dla danego konta.
Uzyskiwanie listy hoteli
Poniższy przykład pobiera listę wszystkich hoteli na koncie 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews
Żądanie akceptuje parametry zapytania do poruszania się po wielostronicowych wynikach:
GET base_url/hotelViews?pageSize=10&pageToken=11
Uzyskiwanie podsumowania usług
Ten przykład pobiera podsumowanie usług na koncie 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize
Raport o udziale
Usługa wyświetlania raportu o udziałach umożliwia wysyłanie zapytań (pobieranie, filtrowanie i segmentowanie) dotyczących raportu o udziałach na konkretnym koncie.
Wykonywanie zapytań dotyczących raportu o uczestnictwie
Poniższy przykład pobiera raport o udziałach dla wszystkich usług na koncie 12345678
i filtruje go według daty 4 października 2020 r.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27
Dokładność cen
Usługa wyświetlania zgodności cen umożliwia pobieranie raportów i kart wyników dotyczących zgodności cen dla konkretnego konta.
Uzyskiwanie raportu zgodności cen
Ten przykład pobiera raport zgodności cen z 26 sierpnia 2019 r. dla konta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
Oprócz zwykłych parametrów zapytania do stronicowania odpowiedzi dostępne są jeszcze 2 parametry, które umożliwiają uwzględnianie w wynikach dopasowanych cen lub sygnałów pikseli.
W tym przykładzie raport dotyczący zgodności cen z 26.08.2019 r. zawiera dopasowane ceny i sygnały pikseli:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
wyświetlanie listy dostępnych raportów dotyczących zgodności cen,
Aby uzyskać listę dostępnych raportów, wyślij to żądanie:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
Możesz uwzględnić zwykłe parametry zapytania do stronicowania wyników.
Uzyskiwanie wyniku zgodności cen
Aby uzyskać kartę wyników zgodności cen, użyj metody summarize
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize
Pokrycie cenowe
Usługa wyświetlania zakresu cen udostępnia najnowszy raport dotyczący zakresu cen lub całą historię zakresu cen.
Uzyskiwanie najnowszych statystyk dotyczących pokrycia cen
Poniższy przykład pokazuje, jak pobrać najnowsze statystyki pokrycia cen dla konta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest
Uzyskiwanie historii zakresu cen
Ta prośba pobiera całą historię pokrycia cen dla konta:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews
Cena
Usługa Price Views Service umożliwia pobieranie raportu cenowego dla danego obiektu.
Pobieranie danych o cenach usługi
Aby uzyskać raport cenowy dla konkretnego hotelu (ID=101
) należącego do konta 12345678
, wyślij to żądanie:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101
Raporty uzgodnień
Usługa raportów uzgodnień umożliwia uzyskanie listy raportów, pobranie konkretnego raportu, sprawdzenie jego poprawności, a następnie przesłanie go do Google.
Uzyskiwanie listy raportów uzgodnień
Ten przykład pobiera listę raportów dla konta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Aby ograniczyć wyniki, możesz uwzględnić opcjonalne parametry zapytania dotyczące daty rozpoczęcia i zakończenia. Na przykład to zapytanie ogranicza raporty do okresu od 15 czerwca 2019 r. do 15 września 2019 r.:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Pobieranie raportu uzgodnień
Ten przykład pobiera raport booking_report.csv
(w formacie JSON), który został przesłany o godzinie 2019-08-26T12:00:00
:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Weryfikowanie raportu uzgodnień
Za pomocą tej metody możesz sprawdzić poprawność raportu przed jego przesłaniem. Sprawdzenie raportu nie powoduje jego przesłania.
Raport uzgodnień jest zawarty w treści żądania jako wartość pola contents
. Raport uzgodnień musi być zgodny ze składnią opisaną w sekcji Raporty uzgodnień.
W tym przykładzie sprawdzamy raport dotyczący konta 12345678
:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Przesyłanie raportu uzgodnień
Po potwierdzeniu, że raport uzgodnień jest prawidłowy, możesz przesłać go do Google, tak jak w tym przykładzie:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports