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

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

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

    • Цены и инвентарь отелей : Установите минимальную цену для маршрута, который соответствует определенным требованиям. Для получения дополнительной информации см. Обновление цен . Вы также можете удалить номер из инвентаря. Для получения дополнительной информации см. Удалить инвентарь .

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

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

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

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

Способы доставки

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

  • В режиме доставки Pull вы отправляете сообщения о транзакциях при получении <Query> от Google.
  • В режиме доставки «Измененные цены» вы отправляете сообщение о транзакции после получения и ответа на <HintRequest> и <Query> .

Более подробную информацию можно найти в разделе Цены и Способы доставки .

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

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

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

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

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