Travel Partner API

Interfejs Travel Partner API udostępnia interfejs RESTowy dla platformy Google Hotel Center. Dzięki niej aplikacja może skutecznie pobierać i zmieniać dane z Hotel Center, więc może zarządzać dużymi i złożonymi kontami.

Usługa: Travelpartner.googleapis.com

Aby zadzwonić do tej usługi, zalecamy użycie bibliotek klienckich udostępnionych przez Google. Jeśli Twoja aplikacja musi użyć własnych bibliotek, aby wywołać tę usługę, użyj tych informacji podczas wysyłania żądań do interfejsu API.

Dokument Discovery

Dokument Discovery to zrozumiała dla komputera specyfikacja dotycząca interfejsów API REST i korzystania z nich. Służy do tworzenia bibliotek klientów, wtyczek IDE i innych narzędzi, które współpracują z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów Discovery. Ta usługa dostarcza następujący dokument opisujący interfejs API:

Punkt końcowy usługi

Punkt końcowy usługi to podstawowy adres URL określający adres sieci usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych usługi. Ta usługa ma następujący punkt końcowy usługi, a wszystkie poniższe identyfikatory URI są zależne od tego punktu końcowego:

  • https://travelpartner.googleapis.com

Zasób REST: v3.accounts.brands

Metody
create POST /v3/{parent=accounts/*}/brands
Utworzy nową markę.
get GET /v3/{name=accounts/*/brands/*}
Zwraca instancję Brand powiązaną z nazwą identyfikatora marki w żądaniu URI.
list GET /v3/{parent=accounts/*}/brands
Zwraca marki dla konta partnera.
patch PATCH /v3/{brand.name=accounts/*/brands/*}
Aktualizuje markę.

Zasób REST: v3.accounts.freeBookingLinksReportViews

Metody
query
(deprecated)		 GET /v3/{name=accounts/*}/freeBookingLinksReportViews:query
WYCOFANO: zamiast tego użyj zdarzenia PropertyPerformanceReportService.QueryPropertyPerformanceReport, które udostępnia też raporty o wyświetleniach.

Zasób REST: v3.accounts.hotelViews

Metody
list GET /v3/{parent=accounts/*}/hotelViews
Zwraca listę widoków hoteli.
summarize GET /v3/{parent=accounts/*}/hotelViews:summarize
Zwraca podsumowanie informacji o hotelach.

Zasób REST: v3.accounts.hotels

Metody
setLiveOnGoogle POST /v3/{account=accounts/*}/hotels:setLiveOnGoogle
Niestandardowa metoda na poziomie kolekcji, która umożliwia aktualizowanie stanu aktywnych w Google wielu usług.

Zasób REST: v3.accounts.icon

Metody
create POST /v3/{parent=accounts/*}/icons
Przesyłaje nową ikonę i rozpoczyna proces sprawdzania.
get GET /v3/{name=accounts/*/icons/*}
Zwraca instancję Icon powiązaną z nazwą zasobu ikony określoną w identyfikatorze URI żądania.
list GET /v3/{parent=accounts/*}/icons
Zwraca wartości Icon w przypadku konta partnera.

Zasób REST: v3.accounts.participationReportViews

Metody
query GET /v3/{name=accounts/*}/participationReportViews:query
Pozwala korzystać z raportów (otrzymywania, filtrowania i segmentowania) dotyczących udziału w konkretnym koncie.

Zasób REST: v3.accounts.priceAccuracyViews

Metody
get GET /v3/{name=accounts/*/priceAccuracyViews/*}
Zwraca w szczegółowym widoku żądany widok dokładności ceny.
list GET /v3/{parent=accounts/*}/priceAccuracyViews
Wyświetla listę dostępnych widoków dokładności cen.
summarize GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize
Zwraca podsumowanie dokładności ceny.

Zasób REST: v3.accounts.pricecoverViews

Metody
getLatest GET /v3/{parent=accounts/*}/priceCoverageViews:latest
Zwraca najbardziej aktualny widok pokrycia ceny.
list GET /v3/{parent=accounts/*}/priceCoverageViews
Zwraca całą historię pokrycia cen.

Zasób REST: v3.accounts.priceViews

Metody
get GET /v3/{name=accounts/*/priceViews/*}
Zwraca pełny widok ceny.

Zasób REST: v3.accounts.propertyPerformanceReportViews

Metody
query GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query
Umożliwia wykonywanie zapytań (pobieranie, filtrowanie i segmentowanie) raportu o skuteczności usługi dotyczących określonego konta.

Zasób REST: v3.accounts.reconciliationRaporty

Metody
create POST /v3/{parent=accounts/*}/reconciliationReports
Utworzy raport uzgodnień i prześle go do Google.
get GET /v3/{name=accounts/*/reconciliationReports/*}
Zwraca raport uzgodnień.
list GET /v3/{parent=accounts/*}/reconciliationReports
Zwraca listę nazw utworzonych raportów uzgodnień.
validate POST /v3/{parent=accounts/*}/reconciliationReports:validate
Sprawdza raport uzgodnień.