Сообщения о транзакциях отправляют данные о номерах, ценах и пакетах в Google. Существует два основных типа сообщений о транзакциях:
Данные маршрута : Определите пакет номеров и данные маршрута, включая:
Цены и ассортимент отелей . Установите минимальную цену для маршрута, отвечающего определенным требованиям. Для получения дополнительной информации см. Обновление цен . Вы также можете удалить комнату из инвентаря. Дополнительную информацию см. в разделе Удаление инвентаря .
Пакеты номеров : установите стоимость маршрута для сочетания физического номера и пакета дополнительных услуг. Для получения дополнительной информации см. Пакеты номеров . Google кэширует содержимое ваших сообщений о транзакциях, чтобы цены были доступны в любое время. В некоторых случаях Google определяет, что значения в его кэше устарели, поэтому он может отправлять дополнительные сообщения
<Query>(или в некоторых случаях запросы Live Pricing Queries ), чтобы получить обновленные цены. Эти данные обычно меняются очень часто. Чтобы определить цену и доступность сообщений о транзакциях, используйте<Result>.
Метаданные номеров и пакетов . Указывает подробную информацию о номерах и пакетах, например описания, фотографии и максимальную вместимость. Эти данные не меняются очень часто. Чтобы определить сообщения транзакции метаданных, используйте
<PropertyDataSet>. Google хранит эти метаданные, чтобы вы могли обращаться к ним из своих сообщений о ценах, а не включать в каждое из них повторяющуюся информацию о номерах и пакетах. Дополнительную информацию см. в разделе Определение метаданных комнаты и пакета .
Корневым элементом сообщения транзакции является <Transaction> . Для сообщений, использующих элемент <Transaction> в качестве корневого элемента, требуется хотя бы один из дочерних элементов. Сообщения транзакций могут иметь любое количество дочерних элементов, если общий размер сообщения не превышает 100 МБ.
Примеры сообщений о транзакциях в ответ на запросы Google см. в справочнике по XML «Цены и инвентаризация номеров (транзакции)» .
Способы доставки
Тип и частота отправки сообщений о транзакциях зависит от вашего режима доставки:
- В режиме доставки по запросу вы отправляете сообщения о транзакциях при получении
<Query>от Google. - В режиме доставки с измененной ценой вы отправляете сообщение транзакции после получения и ответа на
<HintRequest>и<Query>.
Дополнительную информацию см. в разделе Цены на способы доставки .
Запросы цен в реальном времени
Независимо от вашего режима доставки, Google также может отправлять вам запросы, известные как запросы цен в реальном времени . В этих сообщениях-запросах ищутся цены в ответ на текущий поиск. Если вы ответите в течение указанного периода времени, который обычно составляет несколько сотен миллисекунд, ваше объявление может появиться на аукционе. Ваши результаты также могут лучше соответствовать клиенту, включая его страну, тип устройства и количество указанных гостей. Дополнительную информацию см. в разделе Запросы цен в реальном времени .
Размер сообщения
Вы можете включить любую комбинацию обновлений данных в одно сообщение транзакции, но размер каждого сообщения ограничен 100 МБ. Обычно все запросы Pull и Hint имеют ограничение времени ответа в 100 секунд. Тайм-аут — это настраиваемое поле, которое Google может изменить по запросу. Google рекомендует устанавливать время ожидания 10 минут для очень больших сообщений.
Чтобы значительно уменьшить размер сообщения и потенциально избежать проблем с размером сообщений и временем ожидания, используйте сообщения транзакций, чтобы заранее определить метаданные вашей комнаты и пакета . Вы также можете добавлять в сообщения содержимое, заархивированное GNU, добавив Content-Encoding: gzip в заголовки сообщений.