Usage

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:

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

Pełną listę pól żądania i odpowiedzi znajdziesz w katalogu zasobów interfejsu API.

Raport skuteczności nieruchomości

Usługa widoku raportów skuteczności usługi umożliwia przeszukiwanie (pobieranie, filtrowanie i segmentowanie) raportu skuteczności usługi dla danego konta.

Wysyłanie zapytania dotyczącego raportu skuteczności usługi

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

Hotele

Usługa Hotel View zawiera listę wszystkich hoteli lub podsumowanie ich dotyczących dla danego konta.

Pobieranie listy hoteli

Ten przykład pobiera listę wszystkich hoteli na koncie 12345678:

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

Żądanie akceptuje parametry zapytania umożliwiające poruszanie się po wynikach wyszukiwania na wielu stronach:

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

Uzyskiwanie podsumowania właściwości

Ten przykład zawiera podsumowanie właściwości konta 12345678:

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

Raport o udziale w programie

Usługa widoku raportów udziału umożliwia wykonywanie zapytań (pobieranie, filtrowanie i segmentowanie) raportu o konkretnym koncie.

Wysyłanie raportu dotyczącego uczestnictwa

Poniższy przykład przedstawia raport o uczestnictwie wszystkich usług na koncie 12345678 i filtruje go według daty 4.10.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 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

Możesz uwzględnić zwykłe parametry zapytania dotyczące podziału na strony w wynikach.

Uzyskiwanie wyniku dokładności ceny

Aby uzyskać podsumowanie statystyk cen, użyj metody summarize:

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

Pokrycie cen

Usługa wyświetleń pokrywających się cen zawiera najnowszy raport cenowy lub pełną historię cen.

Otrzymywanie statystyk dotyczących pokrycia cen

Ten przykład pokazuje najnowsze statystyki dotyczące pokrycia cen na koncie 12345678:

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

Pobieranie historii pokrycia cen

Ta prośba pobiera całą historię pokrycia cen na koncie:

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

Cena

Usługa wyświetleń cen umożliwia pobieranie raportów dotyczących cen dla danej usługi.

Pobieram dane o cenie usługi

Aby uzyskać raport cenowy dla określonego hotelu (ID=101) należącego do konta 12345678, wyślij tę prośbę:

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

Raporty uzgodnień

Usługa raportów uzgodnień

Pobieranie listy raportów uzgodnień

Oto przykładowy raport o koncie 12345678:

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

Pobieranie raportu uzgodnień

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

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

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