Questa pagina è stata tradotta dall'API Cloud Translation.

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 valido dagli stessi server. In caso di modifiche ai prezzi, 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 rideterminazione dei prezzi, consulta la Panoramica dei prezzi.

I messaggi Hint Response utilizzano i seguenti metodi per rideterminare i prezzi degli hotel selezionati e dei relativi itinerari:

Itinerari esatti
Intervalli di date di check-in
Soggiorni con intervallo di date

L'elemento principale di un messaggio Hint Response è <Hint>. Puoi richiedere l'aggiornamento di un hotel o itinerario tramite 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>. L'elemento <Property> identifica un hotel utilizzando gli stessi ID presenti nell'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 <Item> se utilizzi intervalli di date di check-in o soggiorni con intervallo di date per rideterminare i prezzi.

Flusso di richiesta e risposta degli itinerari esatti

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

Risposta del partnerRisposta di GoogleCrea <Transaction>

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

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

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>

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 degli 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 che iniziano da queste date e si estendono fino alla durata del soggiorno indicata.

Date comprese del partnerRisposta di GoogleCrea <Transaction>

L'esempio seguente di 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>

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>

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 una durata del soggiorno di 5 notti. La durata predefinita del soggiorno è di 30 giorni.

Flusso di richiesta e risposta per i soggiorni con intervallo di date

Un messaggio Hint Response può includere un intervallo di date che sono cambiate. Ciò permette a Google di sapere 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 del partner compresi in un intervalloRisposta di GoogleCrea <Transaction>

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

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

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>

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