Travel Partner API

Interfejs Travel Partner API udostępnia interfejs RESTful do platformy Google Hotel Center. Umożliwia on aplikacji sprawne pobieranie i zmienianie danych Hotel Center, dzięki czemu nadaje się do zarządzania dużymi lub złożonymi kontami.

Usługa: travelpartner.googleapis.com

Zalecamy wywołanie tej usługi przy użyciu dostarczonych przez Google bibliotek klienta. Jeśli aplikacja musi wywoływać tę usługę przy użyciu własnych bibliotek, podczas tworzenia żądań interfejsu API należy używać poniższych informacji.

Dokument opisujący

Dokument opisujący to czytelna dla komputera specyfikacja opisująca interfejsy API REST i sposób ich używania. Służy do tworzenia bibliotek klienta, wtyczek IDE i innych narzędzi, które współdziałają z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów opisujących. 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, który określa adres sieciowy usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych. Ta usługa ma następujący punkt końcowy i wszystkie poniższe identyfikatory URI odnoszą się do niego:

  • https://travelpartner.googleapis.com

Zasób REST: v3.accounts.brands

Metody
create POST /v3/{parent=accounts/*}/brands
Tworzy nową markę.
get GET /v3/{name=accounts/*/brands/*}
Zwraca Brand instancję powiązaną z nazwą zasobu marki w identyfikatorze URI żądania.
list GET /v3/{parent=accounts/*}/brands
Zwraca marki na koncie 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żywaj PropertyPerformanceReportService.QueryPropertyPerformanceReport, która też zawiera raportowanie wyświetleń.

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 podsumowane informacje 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 „Dostępne w Google” w przypadku wielu usług.

Zasób REST: v3.accounts.icons

Metody
create POST /v3/{parent=accounts/*}/icons
Przesyła nową ikonę i rozpoczyna proces jej 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 Icon dla konta partnera.

Zasób REST: v3.accounts.listings

Metody
verify POST /v3/{parent=accounts/*}/listings:verify
Zwraca zweryfikowane wizytówki z problemami z danymi i informacjami o możliwości wyświetlania reklam tylko w przypadku partnerów VR.

Zasób REST: v3.accounts.participationReportViews

Metody
query GET /v3/{name=accounts/*}/participationReportViews:query
Umożliwia wysyłanie zapytań (pobieranie, filtrowanie i segmentowanie) dotyczących raportu o udziałach w przypadku konkretnego konta.

Zasób REST: v3.accounts.priceAccuracyViews

Metody
get GET /v3/{name=accounts/*/priceAccuracyViews/*}
Zwraca widok dokładności ceny w pełnych szczegółach.
list GET /v3/{parent=accounts/*}/priceAccuracyViews
Wyświetla dostępne widoki zgodności cen.
summarize GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize
Zwraca podsumowanie zgodności cen.

Zasób REST: v3.accounts.priceCoverageViews

Metody
getLatest GET /v3/{parent=accounts/*}/priceCoverageViews:latest
Zwraca najnowszy widok pokrycia cen w pełnych szczegółach.
list GET /v3/{parent=accounts/*}/priceCoverageViews
Zwraca całą historię ochrony ceny.

Zasób REST: v3.accounts.priceViews

Metody
get GET /v3/{name=accounts/*/priceViews/*}
Zwraca widok ceny w pełnych szczegółach.

Zasób REST: v3.accounts.propertyPerformanceReportViews

Metody
query GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query
Umożliwia wysyłanie zapytań (pobieranie, filtrowanie i segmentowanie) dotyczących raportu o bezpłatnych linkach do rezerwacji w przypadku konkretnego konta.

Zasób REST: v3.accounts.reconciliationReports

Metody
create POST /v3/{parent=accounts/*}/reconciliationReports
Tworzy raport uzgodnień i przesyła 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
Weryfikuje raport uzgodnień.