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 .