Общие сведения о сообщениях-транзакциях

Сообщения-транзакции передают в Google данные о номерах, ценах и пакетах. Существует два основных типа сообщений-транзакций:

  1. Данные о маршруте. Определите пакет номеров и данные о маршруте, в том числе:

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

    • Пакеты номеров. Укажите цены на маршруты для комбинации физического номера и пакета дополнительных услуг. Подробнее о наборах для переговорных комнат… Google кеширует содержимое сообщений-транзакций, чтобы цены всегда были доступны. В некоторых случаях Google определяет, что значения в кеше устарели, и может отправлять дополнительные сообщения <Query> (или в некоторых случаях запросы цен в режиме реального времени), чтобы получить актуальные цены. Эти данные обычно меняются очень часто. Чтобы задать цены и наличие мест в сообщениях-транзакциях, используйте элемент <Result>.

  2. Метаданные о номерах и пакетах. Содержат подробную информацию о номерах и пакетах, например описания, фотографии и максимальную вместимость. Эти данные не меняются очень часто. Чтобы определить метаданные сообщений-транзакций, используйте <PropertyDataSet>. Google хранит эти метаданные, чтобы вы могли ссылаться на них в сообщениях о ценах, а не включать повторяющуюся информацию о номерах и пакетах в каждое сообщение. Подробнее о том, как задать метаданные для номеров и пакетов…

Корневой элемент сообщения-транзакции – <Transaction>. Сообщения, в которых элемент <Transaction> используется в качестве корневого элемента, должны содержать хотя бы один из дочерних элементов. Сообщения-транзакции могут содержать любое количество дочерних элементов, если общий размер сообщения не превышает 100 МБ.

Примеры сообщений-транзакций, отправляемых в ответ на запросы Google, можно найти в справочнике по XML-фидам цен и номеров (транзакций).

Режимы доставки

Тип и частота отправки сообщений-транзакций зависят от выбранного режима передачи данных:

  • При использовании модели Pull вы отправляете сообщения-транзакции, когда получаете от Google <Query>.
  • При использовании режима "Измененные цены" вы отправляете сообщение-транзакцию после получения и ответа на <HintRequest> и <Query>.

Подробнее о режимах передачи цен…

Запросы цен в режиме реального времени

Независимо от выбранного режима передачи данных Google может отправлять вам запросы цен в режиме реального времени. Эти сообщения-запросы запрашивают цены в ответ на текущий поиск. Если вы ответите в течение указанного периода времени, который обычно составляет несколько сотен миллисекунд, ваше объявление может быть допущено к участию в аукционе. Результаты также могут лучше соответствовать клиенту, включая его страну и тип устройства, а также указанное им количество гостей. Подробнее о запросах цен в режиме реального времени…

Размер сообщения

В одном сообщении-транзакции можно передавать любые комбинации данных, но его размер не должен превышать 100 МБ. Обычно время ответа на запросы Pull и Hint не должно превышать 100 секунд. Время ожидания можно настроить по запросу в Google. Для очень больших писем рекомендуется установить время ожидания, равное 10 минутам.

Чтобы значительно уменьшить размер сообщений и избежать проблем с размером сообщений и тайм-аутами, используйте сообщения-транзакции для предварительного определения метаданных номеров и пакетов. Вы также можете добавить в сообщения контент, сжатый с помощью GNU, добавив в заголовки сообщений Content-Encoding: gzip.