Release Notes

Wersja 3 interfejsu Travel Partner API zapewnia programowy dostęp do:

  • Zarządzanie połączeniami kont między Hotel Center a Google Ads
  • Zarządzanie wybranymi ustawieniami hoteli
  • Zarządzanie markami i ikonami (zamknięta wersja beta)
  • Dane o skuteczności usługi za pomocą usługi wyświetlania raportów o skuteczności usługi
  • Dane hoteli za pomocą usługi Widoki hoteli
  • Dane raportu o udziałach za pomocą usługi wyświetlania raportów o udziałach
  • Dane dotyczące dokładności cen za pomocą usługi Price Accuracy Views Service
  • Dane o zakresie cen za pomocą usługi Price Coverage Views Service
  • Dane dotyczące planu podróży i cen za pomocą usługi Price Views Service
  • Zarządzanie raportami uzgodnień prowizji za pomocą usługi Raporty uzgodnień (dotyczy tylko partnerów, którzy otrzymują prowizję za pobyt)

Punkty końcowe

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

https://travelpartner.googleapis.com

Punkty końcowe usługi
Połączenia z kontami

Zarządza 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ęte testy beta)

POST /v3/accounts/account id/brands
GET /v3/accounts/account id/brands
PATCH /v3/accounts/account id/brands/brand id

Hotele

Modyfikowanie wybranych ustawień hoteli.

POST /v3/accounts/account id/hotels:setLiveOnGoogle

Widoki hoteli

Zwraca listę wyświetleń hotelu lub podsumowanie.

GET /v3/accounts/account id/hotelViews
GET /v3/accounts/account id/hotelViews:summarize

Icons

Zarządzanie ikonami. (zamknięte testy beta)

POST /v3/accounts/account id/icons
GET /v3/accounts/account id/icons/icon id

Wyświetlenia raportu o zaangażowaniu

Zwraca widok raportu o zaangażowaniu lub, za pomocą zapytania, przefiltrowany podzbiór danych widoku.

GET /v3/accounts/account id/participationReportViews
GET /v3/accounts/account id/participationReportViews:query

Wyświetlenia zgodności cen

Zwraca konkretny widok zgodności cen, dostępne widoki zgodności lub podsumowanie.

GET /v3/accounts/account id/priceAccuracyViews/report date
GET /v3/accounts/account id/priceAccuracyViews
GET /v3/accounts/account id/priceAccuracyViews:summarize

Wyświetlenia pokrycia cen

Zwraca widok najnowszych danych o cenach lub całą historię danych.

GET /v3/accounts/account id/priceCoverageViews:latest
GET /v3/accounts/account id/priceCoverageViews

Wyświetlenia ceny

Zwraca szczegółowy widok żądanej ceny.

GET /v3/accounts/account id/priceViews/partner hotel id

Wyświetlenia raportu Skuteczność 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 w interfejsie Travel Partner API w wersji 2.1 zostało przeniesionych do interfejsu Google Ads API. W związku z tym interfejs Travel Partner API w wersji 3 zawiera tylko usługi dotyczące hoteli.

HotelViewService

  • HotelViewService.ListHotelViews (dawniej Hotels API)
    • Punkt końcowy interfejsu API został zmieniony 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.
    • Niektóre pola zostały zmienione.
  • HotelViewService.SummarizeHotelViews (wcześniej hotel_list_stats w interfejsie Scorecard API)
    • Punkt końcowy interfejsu API został zmieniony z https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats na https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize.
    • Niektóre pola zostały zmienione.

ParticipationReportViewService (wcześniej opportunity_stats w interfejsie Scorecard API)

  • ParticipationReportService.QueryParticipationReport
    • Punkt końcowy interfejsu API został zmieniony 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.
    • Pola zostały zmienione i przekształcone.

PriceAccuracyViewService (wcześniej interfejs API raportu price_accuracy)

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • Punkt końcowy interfejsu API został zmieniony 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 hotelu, a nie jak w przypadku poprzedniej wersji listę dat raportów.
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • Punkt końcowy interfejsu API został zmieniony z https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 na https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909.
    • Dane wyjściowe w formacie CSV nie są już obsługiwane.
    • Niektóre pola zostały zmienione.

PriceCoverageViewService

  • PriceAccuracyViewService.ListPriceCoverageViews (wcześniej price_coverage_stats_history w interfejsie Scorecard API)
    • Punkt końcowy interfejsu API został zmieniony z https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history na https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews.
    • Niektóre pola zostały zmienione.
  • PriceAccuracyViewService.GetLatestPriceCoverageViews (wcześniej price_coverage_stats w interfejsie Scorecard API)
    • Punkt końcowy interfejsu API został zmieniony z https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats na https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest.
    • Niektóre pola zostały zmienione.

PriceViewService (wcześniej Prices API)

  • PriceViewService.GetPriceView
    • Punkt końcowy interfejsu API został zmieniony z https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id na https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id.
    • Niektóre pola zostały zmienione.
    • Usunięto z odpowiedzi informacje o stawkach.

Metody ReconciliationReportService (wcześniej Reconciliation Reports API)

  • ReconciliationReportService.ListReconciliationReports
    • Punkt końcowy interfejsu API został zmieniony 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 został zmieniony 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 został zmieniony 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 został zmieniony z https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate na https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.

Wycofanie

Wycofano
oznacza, że wersja interfejsu API będzie nadal działać zgodnie z oczekiwaniami, ale może nie być aktualizowana o nowe funkcje ani poprawki błędów. Dodatkowo po wycofaniu wersji określa się datę jej wycofania.
Wycofane
oznacza, że wersja interfejsu API została usunięta i nie jest już dostępna. Minimalny czas między wycofaniem a zakończeniem działania usługi to 3 miesiące.

W tabeli poniżej znajdziesz aktualny harmonogram wersji interfejsu API oraz oczekiwane daty wycofania i zakończenia działania:

Wersja Data wycofania Data wycofania
v3.0 Nie dotyczy Nie dotyczy
v2.1 Wrzesień 2019 r. 31 maja 2020 r.
v2.0 (Bids API) Luty 2018 r. Maj 2018 r.
wersja 2.0 (wszystkie inne interfejsy API) Wrzesień 2019 r. 15 lutego 2020 r.
1.2 Luty 2018 r. Maj 2018 r.
v1.1 Czerwiec 2016 październiku 2016 r.
v1.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ładową aplikację i dodatkowe informacje o korzystaniu z OAuth do łączenia się z interfejsem Travel Partner API znajdziesz w artykule Uwierzytelnianie w interfejsie API.