Messaggi Hint Response

Quando Google invia una richiesta Hint , i tuoi server deve rispondere con un messaggio Hint Response che specifica gli hotel la cui I prezzi sono cambiati dall'ultima volta che Google ha ricevuto correttamente un Hint Risposta dagli stessi server. In caso di variazioni di prezzo, Google invia un elemento <Query> che recupera i dati sui prezzi aggiornati per l'attributo hotel e itinerari.

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

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

di Gemini Advanced.

L'elemento principale di un messaggio Hint Response è <Hint>. Richiedi un hotel o itinerario da aggiornare utilizzando uno o più elementi <Item>. Un singolo suggerimento Il messaggio di risposta può definire un numero illimitato di elementi <Item>.

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

Flusso di richiesta e risposta dell'itinerario esatto

I messaggi Hint possono essere basati su singoli itinerari, ad esempio la combinazione di data del 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 recupera i nuovi dati sui prezzi dell'itinerario.

Risposta del partner

Il seguente messaggio Hint Response definisce una singola proprietà e una singola 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 seguenti:

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

Crea <Transaction>

Dovrai quindi creare una <Transaction> con gli aggiornamenti dei prezzi per 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, iniziando con dalla prima data del check-in e termina con l'ultima data del check-in. Quando Google recupera nuovi dati sui prezzi, Google estrae itinerari per ogni data di check-in l'hotel a partire da quelle date e si estende fino alla durata del soggiorno che da te indicato.

Date specificate dal partner

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>

Risposta di Google

Google risponde a questo messaggio Hint Response con un carattere <Query> simile a le seguenti:

<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 una <Transaction> con gli aggiornamenti dei prezzi. per i seguenti soggiorni dell'hotel in questione:

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 predefinita del soggiorno di 5 notti.

Flusso di richiesta e risposta dei soggiorni con intervallo

Un messaggio Hint Response può includere un intervallo di date che sono cambiate. Questo comunica a Google che deve recuperare qualsiasi itinerario interessato da uno di questi date. L'insieme effettivo di itinerari recuperati è una funzione di entrambi gli insiemi date con modifiche e la durata massima del soggiorno.

Soggiorni con intervallo di date del partner

Il seguente messaggio Hint Response di esempio 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>

Risposta di Google

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

<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 una <Transaction> con gli aggiornamenti dei prezzi per 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