Hint response messages

Cuando Google envía un Hint request message, tus servidores deberían responder con un Hint response message en el que se especifiquen los hoteles cuyos precios han cambiado desde la última vez que Google recibió un mensaje de este tipo de esos mismos servidores. Si hay cambios en los precios, Google envía un elemento <Query> para obtener los datos de precios actualizados y los itinerarios de los hoteles indicados.

Para obtener información general sobre el proceso de cambio de precios, consulta el artículo sobre cómo actualizar los precios.

Los Hint response messages pueden utilizar los siguientes métodos para especificar los hoteles e itinerarios cuyos precios debe cambiar Google:

La duración predeterminada de la estancia cuando se usa Pull with Hints es de 5 días.

El elemento raíz de un Hint response message es <Hint>. Puedes solicitar que se actualice un hotel o un itinerario mediante uno o varios elementos <Item>. Un solo Hint response message puede incluir un número ilimitado de elementos <Item>.

Cada Hint response message debe especificar al menos un elemento <Property> por cada elemento <Item>. El elemento <Property> identifica un hotel mediante los mismos IDs que los de la lista de hoteles.

De forma predeterminada, debes especificar un solo ID de hotel para cada bloque <Item>. No obstante, puedes pedir a Google que permita varios hoteles en este tipo de bloques si usas periodos de entrada o itinerarios desglosados para los cambios de precio.

Flujo de solicitud o de respuesta de itinerarios exactos

Los Hint messages se pueden basar en itinerarios individuales (combinación de fecha de entrada y duración de la estancia). En este caso, tú especificas la fecha de entrada y la duración de la estancia para los hoteles, y Google solo obtiene los precios actualizados de ese itinerario.

En el siguiente Hint response message se define una única propiedad y un solo itinerario:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2014-06-10</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Google responde a tu Hint response message con un valor de <Query> similar a este:

<Query>
  <Checkin>2014-06-10</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

A continuación, deberás crear un elemento <Transaction> con las actualizaciones de precios del hotel para la siguiente estancia:

6/10/14 - 6/13/14

Flujo de solicitud o de respuesta de periodos de entrada

En un Hint response message, se puede especificar un periodo de entrada empezando por la primera fecha y terminando por la última. Cuando Google obtiene los precios actualizados, extrae itinerarios para todas las fechas de entrada del hotel empezando por estas fechas y extendiéndose hasta la longitud de la estancia que hayas indicado.

En el siguiente Hint response message, se define una sola propiedad con un periodo para el registro:

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2014-06-10</FirstDate>
    <LastDate>2014-06-13</LastDate>
  </Item>
</Hint>

Google responde a este Hint response message con un elemento <Query> similar a este:

<Query>
  <FirstDate>2014-06-10</FirstDate>
  <LastDate>2014-06-12</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

A continuación, se espera que crees un elemento <Transaction> con actualizaciones de precios para las siguientes estancias de ese hotel:

6/10/14 - 6/11/14
6/10/14 - 6/12/14
6/10/14 - 6/13/14
6/10/14 - 6/14/14
6/10/14 - 6/15/14

6/11/14 - 6/12/14
6/11/14 - 6/13/14
6/11/14 - 6/14/14
6/11/14 - 6/15/14
6/11/14 - 6/16/14

6/12/14 - 6/13/14
6/12/14 - 6/14/14
6/12/14 - 6/15/14
6/12/14 - 6/16/14
6/12/14 - 6/17/14

En este ejemplo se utiliza una duración predeterminada de la estancia de 5 noches.

Flujo de solicitud o de respuesta de itinerarios desglosados (o estancias desglosadas)

En un Hint response message, se puede incluir un periodo de noches para un itinerario. Esto indica a Google que debe obtener los itinerarios que contengan cualquiera de esas noches. El conjunto real de itinerarios obtenidos es una combinación del conjunto de noches con los precios modificados y la duración máxima de la estancia.

En el siguiente ejemplo, el Hint response message utiliza estancias desglosadas:

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2014-06-10</FirstDate>
      <LastDate>2014-06-13</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Google responde a tu Hint response message con un valor de <Query> similar a este:

<Query>
  <FirstDate>2014-06-10</FirstDate>
  <LastDate>2014-06-13</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

A continuación, deberás crear un elemento <Transaction> con las actualizaciones de precios del hotel para las siguientes estancias:

6/07/14 - 6/10/14

6/08/14 - 6/10/14
6/08/14 - 6/11/14

6/09/14 - 6/10/14
6/09/14 - 6/11/14
6/09/14 - 6/12/14

6/10/14 - 6/11/14
6/10/14 - 6/12/14
6/10/14 - 6/13/14

6/11/14 - 6/12/14
6/11/14 - 6/13/14
6/11/14 - 6/14/14

6/12/14 - 6/13/14
6/12/14 - 6/14/14
6/12/14 - 6/15/14

6/13/14 - 6/14/14
6/13/14 - 6/15/14
6/13/14 - 6/16/14

Si te fijas, en las estancias desglosadas, es necesario cambiar el precio de todos los itinerarios (incluidos los que empiezan antes de la fecha inicial, pero que se solapan con ella).