Ответные сообщения с подсказками

Когда Google отправляет сообщение с запросом подсказки , ваши серверы должны ответить сообщением с подсказкой, в котором указываются отели, цены в которых изменились с тех пор, как Google в последний раз получал успешный ответ с подсказкой от тех же серверов. Если есть какие-либо изменения цен, Google отправляет <Query> , который получает обновленные данные о ценах для указанных отелей и маршрутов.

Обзор процесса изменения цен см. в Обзоре цен .

В ответных сообщениях с подсказками используются следующие методы для изменения цен на выбранные отели и их маршруты:

Корневым элементом сообщения Hint Response является <Hint> . Вы запрашиваете обновление отеля или маршрута, используя один или несколько элементов <Item> . Одно сообщение Hint Response может определять любое количество элементов <Item> .

В каждом сообщении ответа на подсказку должен быть указан хотя бы один элемент <Property> для каждого <Item> . <Property> идентифицирует отель, используя те же идентификаторы, что и список отелей . По умолчанию вы указываете один идентификатор отеля для каждого блока <Item> . Однако вы можете поручить Google разрешить несколько отелей в блоке позиций, если вы используете диапазоны дат заезда или диапазоны сроков пребывания для переоценки.

Точный запрос маршрута и поток ответов

Сообщения-подсказки могут основываться на отдельных маршрутах, например на сочетании даты заезда и продолжительности пребывания. В этом случае вы указываете дату заезда и продолжительность пребывания в своих отелях, а Google получает новые данные о ценах только для этого маршрута.

Ответ партнера

Следующее сообщение-подсказка-ответ определяет один объект недвижимости и один маршрут: 

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Ответ Google

Google отвечает на ваше сообщение Hint Response с помощью <Query> , подобного следующему: 

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Создать <Transaction>

Затем вы должны создать <Transaction> с обновлениями цен на отель на следующее пребывание: 

5/20/23 - 5/23/23

Последовательность запросов и ответов на диапазоны дат заезда

В ответном сообщении-подсказке может быть указан диапазон дат регистрации, начиная с даты первой регистрации и заканчивая датой последней регистрации. Когда Google получает новые данные о ценах, Google собирает маршруты для каждой даты заезда в отель, начиная с этих дат и вплоть до указанного вами срока пребывания.

Даты партнера в диапазоне

В следующем примере сообщения «Подсказка-ответ» определяется одно свойство с диапазоном дат для регистрации: 

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

Ответ Google

Google отвечает на это сообщение Hint Response с помощью <Query> аналогичного следующему: 

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Создать <Transaction>

Затем вы должны создать <Transaction> с обновлениями цен на следующие пребывания в этом отеле:

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23

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

Последовательность запросов и ответов на ранжированное пребывание

Сообщение-подсказка-ответ может включать диапазон дат, которые изменились. Это сообщает Google, что он должен получить любой маршрут, затронутый любой из этих дат. Фактический набор выбранных маршрутов зависит как от набора дат с изменениями, так и от максимальной продолжительности пребывания.

Ранжированное пребывание партнера

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

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Ответ Google

Google отвечает на ваше сообщение Hint Response с помощью <Query> , подобного следующему: 

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

Создать <Transaction>

Затем вы должны создать <Transaction> с обновлениями цен на отель для следующих пребываний:

5/17/23 - 5/20/23

5/18/23 - 5/20/23
5/18/23 - 5/21/23

5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23