Usage

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