Usage

На этой странице представлены некоторые примеры вызовов с использованием Travel Partner API v3.

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

https://travelpartner.googleapis.com/v3/accounts/account_id

Полный список полей запроса и ответа смотрите в каталоге ресурсов API .

Отчет об эффективности недвижимости

Служба просмотра отчетов об эффективности недвижимости предоставляет возможность запрашивать (получать, фильтровать и сегментировать) отчет об эффективности недвижимости для определенной учетной записи.

Запрос отчета об эффективности недвижимости

В следующем примере получается отчет об эффективности всех объектов недвижимости в учетной записи 12345678 , отфильтрованный по дате 11 мая 2022 года и сгруппированный по идентификатору отеля-партнера.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId

Отели

Служба Hotel View Service предоставляет либо список всех отелей, либо их сводку для конкретной учетной записи.

Получение списка отелей

В следующем примере извлекается список всех отелей в аккаунте 12345678 :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews

Запрос принимает параметры запроса для навигации по многостраничным результатам:

GET base_url/hotelViews?pageSize=10&pageToken=11

Получение сводки свойств

В этом примере получается сводка свойств для учетной записи 12345678 :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize

Отчет об участии

Служба просмотра отчетов об участии предоставляет возможность запрашивать (получать, фильтровать и сегментировать) отчеты об участии для конкретной учетной записи.

Запрос отчета об участии

В следующем примере получается отчет об участии для всех объектов в аккаунте 12345678 и фильтруется отчет по дате 10/4/20.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27

Точность цен

Служба просмотра точности цен позволяет получать отчеты и оценочные листы о точности цен для конкретного аккаунта.

Получение отчета о точности цен

В следующем примере извлекается отчет о точности цен на 26.08.2019 для счета 12345678 :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826

Помимо обычных параметров запроса для пролистывания ответа, есть еще несколько для включения сопоставленных цен или сигналов пикселей в результаты.

В этом примере отчет о точности цен на 26.08.2019 включает сопоставленные цены и сигналы пикселей:

GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true

Перечисление доступных отчетов о точности цен

Чтобы получить список доступных отчетов, отправьте этот запрос:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews

Вы можете включить обычные параметры запроса для пролистывания результатов.

Получение оценки точности цен

Чтобы получить оценку точности цен, используйте метод summarize :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize

Ценовое покрытие

Служба просмотра ценового покрытия предоставляет последний отчет о ценовом покрытии или полную историю ценового покрытия.

Получение последних статистических данных о ценовом покрытии

В следующем примере извлекается последняя статистика покрытия цен для счета 12345678 :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest

Получение истории покрытия цен

Этот запрос получает всю историю покрытия цен для учетной записи:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews

Цена

Сервис просмотра цен позволяет вам получить отчет о ценах на указанную недвижимость.

Получение данных о ценах на недвижимость

Чтобы получить отчет о ценах для конкретного отеля (ID= 101 ), принадлежащего аккаунту 12345678 , выполните следующий запрос:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101

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

Служба отчетов о сверке позволяет получить список отчетов, загрузить определенный отчет, проверить его, а затем загрузить отчет в Google.

Получение списка отчетов по сверке

Следующий пример получает список отчетов для учетной записи 12345678 :

GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports

Вы можете включить необязательные параметры запроса, например, начальную и конечную дату, чтобы ограничить результаты. Например, этот запрос ограничит отчёты только данными за период с 15.06.2019 по 15.09.2019:

GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15

Загрузка отчета о сверке

В этом примере извлекается отчет booking_report.csv (в виде ответа JSON), который был загружен 2019-08-26T12:00:00 :

GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv

Проверка отчета о сверке

Вы можете использовать этот метод для проверки отчёта перед его загрузкой. Проверка отчёта не приводит к его загрузке.

Отчёт о сверке включается в тело запроса в качестве значения поля contents . Отчёт о сверке должен соответствовать синтаксису, описанному в разделе «Отчёты о сверке» .

Следующий пример проверяет отчет для счета 12345678 :

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate

Загрузка отчета о сверке

После того как вы убедились, что отчет о сверке действителен, вы можете загрузить его в Google, как в этом примере:

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports