Если у вас есть системные ограничения, не позволяющие вам поддерживать методы доставки Pull или Pull with Hints, воспользуйтесь формой обратной связи .
Обзор режима доставки push-уведомлений
В режиме доставки Push вы отправляете добавочные обновления всякий раз, когда меняются цены или доступность.
На следующем изображении показан поток запроса/ответа для режима доставки Push:
Настройка Push в файле конфигурации протокола
Чтобы обновить цены в режиме доставки Push, укажите следующие элементы в файле конфигурации протокола. Вы делаете это только при первой настройке среды для работы с API цен на отели:
-
<Model>
: установите значение элемента<Model>
на «push». -
<WhitelistedIPs>
: список ваших IP-адресов, которые вы используете для аутентификации связи между вами и Google. Значением этого элемента может быть список ваших IP-адресов, разделенных точкой с запятой, или диапазон IP-адресов в нотации CIDR. Это принимает форму xxx.xxx.xxx.xxx/YY .
В следующем примере показан файл конфигурации протокола для партнеров, использующих Push:
<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
<Model>push</Model>
<WhiteListedIPs>216.239.32.0/19;64.233.160.0/19</WhiteListedIPs>
</Configuration>
Для получения дополнительной информации обратитесь к файлу конфигурации протокола .
Обновление цен с помощью Push
Чтобы обновить данные с помощью Push, отправляйте сообщение о транзакции всякий раз, когда ваши данные изменяются.
При отправке сообщения о транзакции используйте следующие рекомендации:
- Отправьте сообщение на следующую конечную точку:
-
http://www.google.com/travel/hotels/uploads/price
-
- Используйте метод HTTP POST.
- Установите для заголовка
Content-Type
«application/xml». - Текст сообщения должен соответствовать синтаксису сообщения о транзакции, как описано в разделе «Установка цен » (для обновлений цен) или «Определение метаданных комнаты и пакета» (для обновлений метаданных).
- Для обновления цен определите элемент
<Result>
для каждого маршрута, который вы хотите обновить. Для обновления метаданных определите данные помещения и данные пакета для каждого измененного свойства.
На каждое полученное сообщение о транзакции Google отвечает с сервера HTTP 200 OK
, чтобы указать на успех. Если Google отвечает кодом ошибки HTTP, повторно отправьте сообщение о транзакции. Если вы столкнулись с проблемами при отправке или получении сообщений, обратитесь к разделу «Устранение неполадок с фидами» .
Вы должны отправить сообщение о транзакции для каждого маршрута (комбинация объекта/даты заезда/длительности пребывания), в котором цена изменилась. Вы можете отправлять до 5 сообщений о транзакциях в секунду. Google не будет блокировать сообщения, которые отправляются чаще, чем 5 раз в секунду, но время ожидания вашего сообщения может истечь, ожидая завершения других запросов.
Чтобы уменьшить сетевой трафик, вы можете объединить несколько элементов <Result>
в одно сообщение транзакции.
Google обычно обрабатывает ваши обновленные данные о ценах и доступности примерно за 5 минут. Цены будут удалены через 90 дней.
Дополнительные сведения об использовании сообщений о транзакциях для обновления цен см. в разделе «Установка цен» .
Обновление метаданных комнаты и пакета с помощью Push
Чтобы обновить метаданные комнаты и пакета, отправьте обновления так же, как и любое другое обновление. В этом случае вы отправляете сообщение о транзакции с новой информацией в элементах <RoomData>
и <PackageData>
. Эти элементы являются дочерними элементами элемента <PropertyDataSet>
.
Дополнительные сведения см. в разделе «Определение метаданных помещения и пакета» .
Ошибки режима доставки
Если вы получаете сообщение об ошибке HTTP при отправке сообщения о транзакции в Google, повторите запрос с интервалом в 1, 5 и 20 минут. Если проблема не устранена после 3 попыток, прекратите отправку сообщений и обратитесь к менеджеру своего аккаунта Google.
Когда вы обратитесь к менеджеру своего аккаунта Google, чтобы сообщить об ошибке HTTP, которую вы получили при отправке сообщения о транзакции, Google проведет тесты примерно для 10 отелей, работая с вами, чтобы убедиться, что ваши фиды настроены правильно. Если тесты пройдены успешно, Google сканирует полный набор отелей, указанных в вашем фиде цен на отели . Это гарантирует, что нагрузки будут приемлемыми, а ваши цены останутся точными в течение 3–5 дней. После этого Google уведомляет вас о запуске, после чего вы сможете ссылаться на свои результаты в реальном времени.
С какой периодичностью следует повышать цены?
В идеале вы отправляете все обновления, как только узнаете, что цена изменилась. Если вы не знаете, когда изменились цены, постарайтесь обновлять цены как можно чаще. Обычно это включает в себя несколько толчков в день. Как правило, маршруты на текущий день и неделю проталкиваются гораздо чаще.