Travel Partner API

API Travel Partner предоставляет RESTful-интерфейс для платформы Google Hotel Center. Он позволяет приложению эффективно извлекать и изменять данные Hotel Center и, таким образом, подходит для управления большими и сложными аккаунтами.

Сервис: travelpartner.googleapis.com

Для вызова этой службы мы рекомендуем использовать клиентские библиотеки, предоставленные Google. Если вашему приложению необходимо использовать ваши собственные библиотеки для вызова этой службы, используйте следующую информацию при выполнении запросов к API.

Документ открытия

Документ обнаружения (Discovery Document) — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов IDE и других инструментов, взаимодействующих с API Google. Один сервис может предоставлять несколько документов обнаружения. Этот сервис предоставляет следующий документ обнаружения:

Конечная точка службы

Конечная точка сервиса — это базовый URL-адрес, который определяет сетевой адрес сервиса API. Один сервис может иметь несколько конечных точек сервиса. Этот сервис имеет следующую конечную точку сервиса, и все указанные ниже URI относятся к этой конечной точке сервиса:

  • https://travelpartner.googleapis.com

Ресурс REST: v3.accounts.brands

Методы
create POST /v3/{parent=accounts/*}/brands
Создает новый бренд.
get GET /v3/{name=accounts/*/brands/*}
Возвращает экземпляр Brand , связанный с именем ресурса бренда URI запроса.
list GET /v3/{parent=accounts/*}/brands
Возвращает бренды для партнерского аккаунта.
patch PATCH /v3/{brand.name=accounts/*/brands/*}
Обновляет бренд.

Ресурс REST: v3.accounts.freeBookingLinksReportViews

Методы
query
(deprecated)		 GET /v3/{name=accounts/*}/freeBookingLinksReportViews:query
УСТАРЕЛО: Вместо этого используйте PropertyPerformanceReportService.QueryPropertyPerformanceReport , который также предоставляет отчеты о впечатлениях.

Ресурс REST: v3.accounts.hotelViews

Методы
list GET /v3/{parent=accounts/*}/hotelViews
Возвращает список представлений об отелях.
summarize GET /v3/{parent=accounts/*}/hotelViews:summarize
Возвращает обобщенную информацию об отелях.

Ресурс REST: v3.accounts.hotels

Методы
setLiveOnGoogle POST /v3/{account=accounts/*}/hotels:setLiveOnGoogle
Пользовательский метод на уровне коллекции для обновления статуса Live on Google для нескольких объектов.

Ресурс REST: v3.accounts.icons

Методы
create POST /v3/{parent=accounts/*}/icons
Загружает новый значок и начинает процесс его проверки.
get GET /v3/{name=accounts/*/icons/*}
Возвращает экземпляр Icon , связанный с именем ресурса значка, указанным в URI запроса.
list GET /v3/{parent=accounts/*}/icons
Возвращает Icon для партнерского аккаунта.

Ресурс REST: v3.accounts.listings

Методы
verify POST /v3/{parent=accounts/*}/listings:verify
Возвращает проверенные листинги с проблемами данных и правами на обслуживание только для VR-партнеров.

Ресурс REST: v3.accounts.participationReportViews

Методы
query GET /v3/{name=accounts/*}/participationReportViews:query
Предоставляет возможность запрашивать (получать, фильтровать и сегментировать) отчет об участии для конкретной учетной записи.

Ресурс REST: v3.accounts.priceAccuracyViews

Методы
get GET /v3/{name=accounts/*/priceAccuracyViews/*}
Возвращает запрошенную точность цен в полном объеме.
list GET /v3/{parent=accounts/*}/priceAccuracyViews
Перечисляет доступные представления точности цен.
summarize GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize
Возвращает сводку точности цен.

Ресурс REST: v3.accounts.priceCoverageViews

Методы
getLatest GET /v3/{parent=accounts/*}/priceCoverageViews:latest
Возвращает последний обзор ценового покрытия в полном объеме.
list GET /v3/{parent=accounts/*}/priceCoverageViews
Возвращает всю историю ценового покрытия.

Ресурс REST: v3.accounts.priceViews

Методы
get GET /v3/{name=accounts/*/priceViews/*}
Возвращает запрошенное представление цен в полном объеме.

Ресурс REST: v3.accounts.propertyPerformanceReportViews

Методы
query GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query
Предоставляет возможность запрашивать (получать, фильтровать и сегментировать) отчет о бесплатных ссылках бронирования для определенной учетной записи.

Ресурс REST: v3.accounts.reconciliationReports

Методы
create POST /v3/{parent=accounts/*}/reconciliationReports
Создает отчет о сверке и загружает его в Google.
get GET /v3/{name=accounts/*/reconciliationReports/*}
Возвращает отчет о сверке.
list GET /v3/{parent=accounts/*}/reconciliationReports
Возвращает список названий созданных отчетов сверки.
validate POST /v3/{parent=accounts/*}/reconciliationReports:validate
Проверяет отчет о сверке.