Messaggi Hint Response

Quando Google invia un messaggio Hint Request, i tuoi server devono rispondere con un messaggio Hint Response che specifica gli hotel i cui prezzi sono cambiati dall'ultima volta in cui Google ha ricevuto un messaggio Hint Response riuscito dagli stessi server. In caso di variazioni di prezzo, Google invia un elemento <Query> che recupera i dati aggiornati sui prezzi per gli hotel e gli itinerari indicati.

Per una panoramica del processo di ricalcolo dei prezzi, consulta la Panoramica dei prezzi.

I messaggi Hint Response utilizzano i seguenti metodi per ricalcolare il prezzo degli hotel selezionati e dei relativi itinerari:

L'elemento principale di un messaggio Hint Response è <Hint>. Puoi richiedere l'aggiornamento di un hotel o un itinerario utilizzando uno o più elementi <Item>. Un singolo messaggio Hint Response può definire un numero illimitato di elementi <Item>.

Ogni messaggio Hint Response deve specificare almeno un elemento <Property> per ogni <Item>. <Property> identifica un hotel utilizzando gli stessi ID dell'elenco hotel. Per impostazione predefinita, devi specificare un solo ID hotel per ogni blocco <Item>. Tuttavia, puoi indicare a Google di consentire più hotel in un blocco articoli se utilizzi intervalli di date di check-in o soggiorni con intervallo di date per il ricalcolo del prezzo.

Flusso di richiesta e risposta di itinerario esatto

I messaggi Hint possono essere basati su singoli itinerari, ad esempio una combinazione di data di check-in e durata del soggiorno. In questo caso, devi specificare una data di check-in e una durata del soggiorno per i tuoi hotel e Google recupera i nuovi dati sui prezzi solo per l'itinerario in questione.

Risposta del partner

Il seguente messaggio Hint Response definisce una singola proprietà e un singolo itinerario:

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

Risposta di Google

Google risponde al tuo messaggio Hint Response con un elemento <Query> simile al seguente:

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

Crea <Transaction>

Dovrai quindi creare un elemento <Transaction> con gli aggiornamenti dei prezzi per l'hotel per il seguente soggiorno:

5/20/23 - 5/23/23

Flusso di richiesta e risposta per gli intervalli di date di check-in

Un messaggio Hint Response può specificare un intervallo di date di check-in, che inizia con la prima data di check-in e termina con l'ultima data di check-in. Quando Google recupera i nuovi dati sui prezzi, estrae gli itinerari per ogni data di check-in per l'hotel a partire da queste date e fino a raggiungere la durata del soggiorno indicata.

Date comprese nell'intervallo del partner

L'esempio seguente per il messaggio Hint Response definisce una singola proprietà con un intervallo di date per il check-in:

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

Risposta di Google

Google risponde a questo messaggio Hint Response con un elemento <Query> simile al seguente:

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

Crea <Transaction>

Dovrai quindi creare un elemento <Transaction> con gli aggiornamenti dei prezzi per i seguenti soggiorni per quell'hotel:

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

In questo esempio viene utilizzata la durata del soggiorno predefinita di 5 notti.

Intervallo di soggiorni con flusso di richiesta e risposta

Un messaggio Hint Response può includere un intervallo di date che sono cambiate. In questo modo, informa Google che deve recuperare qualsiasi itinerario interessato da una di queste date. L'insieme effettivo di itinerari recuperati è in funzione sia dell'insieme di date con modifiche sia della durata massima del soggiorno.

Soggiorni con intervallo di date del partner

L'esempio di messaggio Hint Response seguente utilizza i soggiorni con intervallo di date:

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

Risposta di Google

Google risponde al tuo messaggio Hint Response con un elemento <Query> simile al seguente:

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

Crea <Transaction>

Dovrai quindi creare un elemento <Transaction> con gli aggiornamenti dei prezzi per l'hotel per i seguenti soggiorni:

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