Ta strona została przetłumaczona przez Cloud Translation API.

Release Notes

Wersja 3 interfejsu Travel Partner API daje automatyczny dostęp do:

Zarządzanie połączeniami między kontem Hotel Center a kontem Google Ads
Zarządzanie wybranymi ustawieniami hoteli
Zarządzanie markami i ikonami (zamknięta wersja beta)
Dane o skuteczności obiektu powiązane z widokiem raportu skuteczności usługi
Dane o hotelach dostępne w usłudze Hotel View
Dane raportu uczestnictwa poprzez usługę wyświetleń raportu udziału
Dane dotyczące dokładności cen dzięki usłudze Widok dokładności cen
Dane na temat pokrycia cen w usłudze Widok ceny
Plany podróży i cenniki za pomocą usługi View Price
Zarządzanie raportami uzgodnień prowizji za pomocą usługi raportów uzgodnień (tylko partnerzy korzystający ze strategii Prowizje od płatności za pobyt)

Punkty końcowe

Punkty końcowe interfejsu Travel Partner API są dostępne za pomocą składni REST używanej w wywołaniach HTTPS. Podstawowy URL dla wszystkich żądań to:

https://travelpartner.googleapis.com

Punkty końcowe usługi
Łączenie kont	Zarządzaj połączeniami między kontem Google Ads a kontem Hotel Center. `POST /v3/accounts/account id/accountLinks DELETE /v3/accounts/account id/accountLinks/account link id GET /v3/accounts/account id/accountLinks/account link id GET /v3/accounts/account id/accountLinks PATCH /v3/accounts/account id/accountLinks/account link id`
Marki	Zmodyfikuj konfigurację marki. (zamknięta wersja beta) `POST /v3/accounts/account id/brands GET /v3/accounts/account id/brands PATCH /v3/accounts/account id/brands/brand id`
Hotele	Zmień wybrane ustawienia hotelu. `POST /v3/accounts/account id/hotels:setLiveOnGoogle`
Widoki hoteli	Zwraca listę widoków danych hotelu lub podsumowanie. `GET /v3/accounts/account id/hotelViews GET /v3/accounts/account id/hotelViews:summarize`
Ikony	Zarządzaj ikonami. (zamknięta wersja beta) `POST /v3/accounts/account id/icons GET /v3/accounts/account id/icons/icon id`
Wyświetlenia raportu o wyświetleniach	Zwraca widok raportu dotyczącego udziału lub, korzystając z zapytania, zwraca filtrowany podzbiór danych widoku. `GET /v3/accounts/account id/participationReportViews GET /v3/accounts/account id/participationReportViews:query`
Widoki dokładności cen	Zwraca określony widok dokładności ceny, dostępne widoki dokładności lub podsumowanie. `GET /v3/accounts/account id/priceAccuracyViews/report date GET /v3/accounts/account id/priceAccuracyViews GET /v3/accounts/account id/priceAccuracyViews:summarize`
Widoki pokrycia cen	Zwraca najnowszy widok zasięgu lub całą historię pokrycia. `GET /v3/accounts/account id/priceCoverageViews:latest GET /v3/accounts/account id/priceCoverageViews`
Wyświetlenia cen	Zwraca pełny widok ceny. `GET /v3/accounts/account id/priceViews/partner hotel id`
Widoki raportów skuteczności usługi	Zwraca widok raportu skuteczności usługi za pomocą zapytania. `GET /v3/accounts/account id/participationReportViews:query`
Raporty uzgodnień	Tworzy, weryfikuje i pobiera raporty uzgodnień prowizji (tylko w przypadku reklam hoteli). `POST /v3/accounts/account id/reconciliationReports POST /v3/accounts/account id/reconciliationReports:validate GET /v3/accounts/account id/reconciliationReports/datetime~filename GET /v3/accounts/account id/reconciliationReports`

Identyfikator konta możesz sprawdzić w widoku Informacje o koncie na karcie Konto w Hotel Ads Center.

Historia zmian

Wiele usług interfejsu Travel Partner API 2.1 zostało przeniesionych do interfejsu Google Ads API. Z tego powodu interfejs Travel Partner API v3 przechowuje tylko usługi związane z hotelami.

Usługa HotelView

HotelViewService.ListHotelViews (dawniej interfejs API hoteli)
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/hotels na https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews.
- Usunięto parametr żądania type.
- Usunięto pole manifestOnly z odpowiedzi.
- Zmieniono nazwy niektórych pól.
HotelViewService.SummarizeHotelViews (dawniej hotel_list_stats w interfejsie Scorecard API)
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats na https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize.
- Zmieniono nazwy niektórych pól.

ParticipationReportViewService (wcześniej możliwość_stats w interfejsie Scorecard API)

ParticipationReportService.QueryParticipationReport
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats na https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query.
- Parametry zapytania zostały dodane.
- Zmieniliśmy nazwy pól i zmieniliśmy ich strukturę.

PriceAccuracyViewService (dawniej interfejs price_accuracy report API)

PriceAccuracyViewService.ListPriceAccuracyViews
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy na https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
- Nowy interfejs API zwraca listę nazw zasobów widoku hoteli w porównaniu z poprzednią wersją, która zwraca listę dat raportu.
PriceAccuracyViewService.ListPriceAccuracyViews
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 na https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909.
- Format wyjściowy pliku CSV nie jest już obsługiwany.
- Zmieniono nazwy niektórych pól.

UsługaViewViewPrice

PriceAccuracyViewService.ListPriceCoverageViews (dawniej price_coverage_stats_history w interfejsie Scorecard API)
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history na https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews.
- Zmieniono nazwy niektórych pól.
PriceAccuracyViewService.GetLatestPriceCoverageViews (dawniej price_coverage_stats w interfejsie Scorecard API)
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats na https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest.
- Zmieniono nazwy niektórych pól.

PriceViewService (wcześniej Prices API)

PriceViewService.GetPriceView
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id na https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id.
- Zmieniono nazwy niektórych pól.
- Usunięto z odpowiedzi informacje o stawkach.

Metody ReconciliationReportService (dawniej Reconciliation Reports API)

ReconciliationReportService.ListReconciliationReports
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports na https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
ReconciliationReportService.GetReconciliationReport
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename na https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename.
ReconciliationReportService.CreateReconciliationReport
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports na https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
ReconciliationReportService.ValidateReconciliationReport
- Punkt końcowy interfejsu API zmienił się z https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate na https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.

Wycofanie

Wycofane: Wskazuje, że wersja interfejsu API będzie nadal działać prawidłowo, ale może nie być aktualizowana o nowe funkcje lub poprawki. Dodatkowo po wycofaniu wersji określana jest data zachodu słońca.
Zachód słońca: Wskazuje, że wersja interfejsu API została usunięta i nie jest już dostępna. Minimalny czas między wycofaniem a wycofaniem to 3 miesiące.

Poniższa tabela przedstawia aktualny harmonogram wersji interfejsu API, a także oczekiwane daty wycofania i wycofania:

Wersja	Data wycofania	Data zachodu słońca
wersja 3.0	Nie dotyczy	Nie dotyczy
wersja 2.1	Wrzesień 2019 r.	31 maja 2020 r.
Wersja 2.0 (Bids API)	Luty 2018 r.	Maj 2018 r.
Wersja 2.0 (pozostałe interfejsy API)	Wrzesień 2019 r.	15 lutego 2020 r.
1.2	Luty 2018 r.	Maj 2018 r.
wersja 1.1	Czerwiec 2016	październiku 2016 r.
wersja 1.0	Kwiecień 2015	październiku 2015 r.

Uwierzytelnianie

Aby uzyskać dostęp do interfejsu Travel Partner API, klienci muszą uwierzytelnić się za pomocą uwierzytelniania OAuth2.

Przykładowa aplikacja i dodatkowe informacje o używaniu protokołu OAuth do łączenia się z interfejsem Travel Partner API znajdziesz w artykule Uwierzytelnianie interfejsu API.