Эта страница переведена с помощью Cloud Translation API.

Release Notes

Версия 3 API Travel Partner предоставляет программный доступ к:

Управление связями аккаунтов между Hotel Center и Google Ads
Управление выбранными настройками отеля
Управление брендами и иконками (закрытая бета)
Данные об эффективности объекта через службу просмотра отчетов об эффективности объекта
Данные отеля через сервис Hotel Views
Данные отчета об участии через службу просмотра отчетов об участии
Данные о точности цен через службу просмотра точности цен
Данные о покрытии цен через службу просмотра покрытия цен
Данные о маршруте и ценах через службу просмотра цен
Управление отчетами о сверке комиссий через Службу отчетов о сверке (только для партнеров с оплатой за проживание)

Конечные точки

Конечные точки API Travel Partner доступны через синтаксис REST-ful из вызовов HTTPS. Базовый URL для всех запросов:

https://travelpartner.googleapis.com

Конечные точки службы
Ссылки на учетные записи	Управляет связями между аккаунтом Google Ads и аккаунтом 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`
Бренды	Изменить конфигурацию бренда. (закрытое бета-тестирование) `POST /v3/accounts/ account id /brands GET /v3/accounts/ account id /brands PATCH /v3/accounts/ account id /brands/ brand id`
Отели	Изменить выбранные настройки отеля. `POST /v3/accounts/ account id /hotels:setLiveOnGoogle`
Виды на отель	Возвращает список просмотров отеля или сводку. `GET /v3/accounts/ account id /hotelViews GET /v3/accounts/ account id /hotelViews:summarize`
Иконки	Управление иконками. (закрытое бета-тестирование) `POST /v3/accounts/ account id /icons GET /v3/accounts/ account id /icons/ icon id`
Просмотры отчета об участии	Возвращает представление отчета об участии или, используя запрос, возвращает отфильтрованное подмножество данных представления. `GET /v3/accounts/ account id /participationReportViews GET /v3/accounts/ account id /participationReportViews:query`
Просмотры точности цены	Возвращает конкретное представление точности цены, доступные представления точности или сводку. `GET /v3/accounts/ account id /priceAccuracyViews/ report date GET /v3/accounts/ account id /priceAccuracyViews GET /v3/accounts/ account id /priceAccuracyViews:summarize`
Просмотры ценового покрытия	Возвращает последнее представление ценового покрытия или всю историю покрытия. `GET /v3/accounts/ account id /priceCoverageViews:latest GET /v3/accounts/ account id /priceCoverageViews`
Просмотры цены	Возвращает запрошенный просмотр цены во всех деталях. `GET /v3/accounts/ account id /priceViews/ partner hotel id`
Просмотры отчета об эффективности недвижимости	Возвращает представление отчета об эффективности свойства с помощью запроса. `GET /v3/accounts/ account id /participationReportViews:query`
Отчеты о сверке	Создает, проверяет и извлекает отчеты о сверке комиссий (только для рекламы гостиниц). `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`

Вы можете найти идентификатор своей учетной записи в представлении « Информация об учетной записи » на вкладке «Учетная запись» в Центре рекламы отелей .

Список изменений

Многие сервисы из Travel Partner API версии 2.1 были перенесены в Google Ads API . В результате Travel Partner API версии 3 сохраняет только услуги, характерные для отелей.

ОтельВидСервис

HotelViewService.ListHotelViews (ранее API отелей)
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/hotels на https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews .
- Удален параметр запроса type .
- Убрано поле manifestOnly в ответе.
- Некоторые поля были переименованы.
HotelViewService.SummarizeHotelViews (ранее hotel_list_stats в Scorecard API)
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats на https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize .
- Некоторые поля были переименованы.

Участие Репортвиевсервис (ранее возможность_статистика в Scorecard API)

ParticipationReportService.QueryParticipationReport
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats на https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query .
- Добавлены параметры запроса.
- Поля были переименованы и реструктурированы.

PriceAccuracyViewService (ранее API отчетов price_accuracy)

PriceAccuracyViewService.ListPriceAccuracyViews
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy на https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews .
- Новый API возвращает список имен ресурсов просмотра отелей, в отличие от предыдущей версии, которая возвращает список дат отчета.
PriceAccuracyViewService.ListPriceAccuracyViews
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 на https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909 .
- Вывод CSV больше не поддерживается.
- Некоторые поля были переименованы.

ЦенаПокрытияПросмотрСервис

PriceAccuracyViewService.ListPriceCoverageViews (ранее price_coverage_stats_history в Scorecard API)
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history на https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews .
- Некоторые поля были переименованы.
PriceAccuracyViewService.GetLatestPriceCoverageViews (ранее price_coverage_stats в Scorecard API)
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats на https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest .
- Некоторые поля были переименованы.

PriceViewService (ранее Prices API)

PriceViewService.GetPriceView
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id на https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id .
- Некоторые поля были переименованы.
- Удалена информация о ставках из ответа.

Методы ReconciliationReportService (ранее API отчетов о сверке)

ReconciliationReportService.ListReconciliationReports
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports на https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports .
ReconciliationReportService.GetReconciliationReport
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename на https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename . .
ReconciliationReportService.CreateReconciliationReport
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports на https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports .
ReconciliationReportService.ValidateReconciliationReport
- Конечная точка API изменилась с https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate на https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate .

Устаревание

Устаревший: указывает, что версия API будет по-прежнему функционировать должным образом, но может не обновляться новыми функциями или исправлениями ошибок. Кроме того, когда версия устаревает, определяется дата истечения срока ее действия.
Закат: указывает, что версия API удалена и больше недоступна. Минимальный промежуток времени между устареванием и закатом составляет 3 месяца.

В следующей таблице показано текущее расписание версий API, а также ожидаемые даты устаревания и прекращения действия:

Версия	Дата устаревания	Дата заката
v3.0	Н/Д	Н/Д
v2.1	сентябрь 2019 г.	31 мая 2020 г.
v2.0 (API ставок)	февраль 2018	май 2018 г.
v2.0 (все остальные API)	сентябрь 2019 г.	15 февраля 2020 г.
v1.2	февраль 2018	май 2018 г.
v1.1	июнь 2016 г.	Октябрь 2016 г.
v1.0	апрель 2015 г.	Октябрь 2015 г.

Аутентификация

Чтобы получить доступ к API Travel Partner, клиенты должны пройти аутентификацию с использованием аутентификации OAuth2 .

Пример приложения и дополнительную информацию об использовании OAuth для подключения к API Travel Partner см. в разделе Аутентификация API .