Release Notes

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

  • Управление связями аккаунтов между Hotel Center и Google Ads
  • Управление выбранными настройками отеля
  • Управление брендами и иконками (закрытая бета-версия)
  • Данные об эффективности недвижимости через Службу просмотра отчетов об эффективности недвижимости
  • Данные об отелях через службу Hotel Views
  • Данные отчета об участии через Службу просмотра отчетов об участии
  • Данные о точности цен через службу Price Accuracy Views Service
  • Данные о ценовом охвате через службу просмотра ценового охвата
  • Данные о маршруте и ценах через сервис Price Views
  • Управление отчетами о сверке комиссий через Службу отчетов о сверке (только для партнеров, оплачивающих комиссию за проживание)

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

Доступ к конечным точкам API Travel Partner осуществляется через REST-полный синтаксис 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

Отчеты о сверке

Создает, проверяет и извлекает отчеты о сверке комиссий (только для Hotel Ads).

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 v2.1 были перенесены в Google Ads API . В результате в Travel Partner API v3 остались только сервисы, специфичные для отелей.

HotelViewService

  • 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 .
    • Некоторые поля были переименованы.

ParticipationReportViewService (ранее opportunities_stats в 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 в API Scorecard)
    • Конечная точка 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, а также ожидаемые даты прекращения поддержки и прекращения поддержки:

Версия Дата прекращения поддержки Дата заката
версия 3.0 Н/Д Н/Д
версия 2.1 Сентябрь 2019 г. 31 мая 2020 г.
v2.0 (API ставок) Февраль 2018 г. Май 2018 г.
v2.0 (все остальные API) Сентябрь 2019 г. 15 февраля 2020 г.
версия 1.2 Февраль 2018 г. Май 2018 г.
версия 1.1 Июнь 2016 г. Октябрь 2016 г.
версия 1.0 Апрель 2015 г. Октябрь 2015 г.

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

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

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