Créer un message d’indice

Si vous vous inscrivez à des demandes d’extraction avec indicateur, Microsoft envoie un message avec le formulaire suivant au point de terminaison que vous spécifiez vous demandant d’identifier les modifications apportées à l’itinéraire depuis la dernière demande de tirage. Vous décidez de la fréquence des demandes au moment de votre intégration.

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="123-abc" timestamp="2017-10-21T08:45:09Z">
  <LastFetchTime>2017-10-21T08:30:16Z</LastFetchTime>
</HintRequest>

L’élément LastFetchTime identifie la date et l’heure UTC de la dernière réponse réussie que vous avez envoyée à Microsoft pour identifier les modifications d’itinéraire. Si aucune modification n’a été apportée depuis cette date, votre réponse doit contenir un corps vide. S’il y a eu des changements, le corps contient un message d’indice , qui identifie les itinéraires qui ont changé. Vous pouvez identifier les itinéraires à l’aide de l’une des méthodes suivantes :

Itinéraires exacts

Votre message d’indice permet d’identifier les itinéraires individuels à l’aide de la date d’case activée et de la durée du séjour. L’exemple suivant montre un message d’indicateur qui spécifie un seul itinéraire pour un seul hôtel.

<Hint>
  <Item>
    <Property>789</Property>
    <Stay>
      <CheckInDate>2017-10-20</CheckInDate>
      <LengthOfStay>2</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Chaque <élément> représente un itinéraire individuel. Vous pouvez spécifier un <objet Item> pour chaque itinéraire que vous souhaitez mettre à jour, et chaque itinéraire peut spécifier une ou plusieurs propriétés.

Lorsque Microsoft reçoit l’indicateur ci-dessus, il vous envoie le message de requête suivant :

<Query>
  <Checkin>2017-10-20</Checkin>
  <Nights>2</Nights>
  <PropertyList>
    <Property>789</Property>
  </PropertyList>
</Query>

Lorsque vous recevez le message de requête, votre réponse doit contenir un flux de prix avec le résultat> suivant<.

  <Result>
    <Property>789</Property>
    <Checkin>2017-10-20</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>

Si l’indicateur ci-dessus spécifie deux propriétés, le flux de prix contient deux <éléments Result> (un pour chaque propriété).

Plages de dates d’archivage

Votre message d’indice peut identifier une plage d’itinéraires. Pour spécifier la plage, définissez l’élément FirstDate sur la date de début de la case activée et sur la LastDate date de la dernière case activée. L’exemple suivant montre un message d’indicateur qui utilise une plage de dates pour spécifier six dates de case activée pour une seule propriété.

<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>123</Property>
    <FirstDate>2017-10-20</FirstDate>
    <LastDate>2017-10-25</LastDate>
  </Item>
</Hint>

Chaque <élément> représente une seule plage de dates d’enregistrement en case activée. Vous pouvez spécifier un <objet Item> pour chaque plage de dates d’case activée qui identifie les itinéraires que vous souhaitez mettre à jour, et chacun peut spécifier une ou plusieurs propriétés.

Lorsque Microsoft reçoit l’indicateur ci-dessus, il vous envoie le message de requête suivant.

<Query>
  <FirstDate>2017-10-20</FirstDate>
  <LastDate>2017-10-25</LastDate>
  <Nights>3</Nights>
  <PropertyList>
    <Property>123</Property>
  </PropertyList>
</Query>

Lorsque vous recevez le message de requête, votre réponse doit contenir un flux de prix avec les objets de résultat> suivants<.

  <Result>
    <Property>789</Property>
    <Checkin>2017-10-20</Checkin>
    <Nights>1</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-20</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-20</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>

  . . .
  
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>1</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>

Pour cet exemple, le nombre maximal de résultats que le flux de prix doit contenir est de 18 (6 dates d’enregistrement de case activée * 3 nuits). Votre flux de prix peut contenir moins si certains itinéraires dont la plage de dates n’a pas changé.

Plages de dates d’enregistrement de la case activée étendues

L’indicateur de plage de dates d’enregistrement de case activée développée est similaire à l’indicateur de plage de dates d’case activée, sauf qu’il vous demande d’inclure tous les itinéraires qui croisent les itinéraires dans la plage de dates. Par conséquent, votre flux de prix doit inclure tout itinéraire dont la date de case activée de départ est comprise dans la plage de dates.

StaysIncludingRange <> identifie l’indicateur comme un indicateur de plage de dates d’case activée étendue. Pour spécifier la plage, définissez l’élément FirstDate sur la date de début de la case activée et sur la LastDate date de la dernière case activée. L’exemple suivant montre un message d’indicateur qui utilise une plage de dates pour spécifier six dates de case activée pour une seule propriété.

<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>123</Property>
    <StaysIncludingRange>
      <FirstDate>2017-10-20</FirstDate>
      <LastDate>2017-10-25</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Chaque <article> représente une seule gamme d’itinéraires. Vous pouvez spécifier un <objet Item> pour chaque plage de dates d’case activée qui identifie les itinéraires que vous souhaitez mettre à jour, et chacun peut spécifier une ou plusieurs propriétés.

Lorsque Microsoft reçoit l’indicateur ci-dessus, il vous envoie le message de requête suivant. Le MaxLengthOfStay paramètre de votre message QueryControl détermine la valeur de <AffectedNights> (cet exemple suppose qu’il est défini sur 3).

<Query>
  <FirstDate>2017-10-20</FirstDate>
  <LastDate>2017-10-25</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>123</Property>
  </PropertyList>
</Query>

Lorsque vous recevez le message de requête, votre réponse doit contenir un flux de prix avec les objets de résultat> suivants<. Notez que la date d’entrée case activée des premiers objets est antérieure à la date de FirstDate votre indicateur. Cela est dû au fait que la date case activée sortie des itinéraires est comprise dans la plage de dates de l’indicateur.

  <Result>
    <Property>789</Property>
    <Checkin>2017-10-17</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-18</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-18</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-19</Checkin>
    <Nights>1</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-19</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-19</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-20</Checkin>
    <Nights>1</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>

  . . .
  
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>1</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>2</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>
  <Result>
    <Property>789</Property>
    <Checkin>2017-10-25</Checkin>
    <Nights>3</Nights>
    <!-- Pricing and other elements that changed -->
  </Result>

Traitement par lot des requêtes

En fonction du nombre de propriétés et d’itinéraires que vous devez mettre à jour, Microsoft vous envoie plusieurs requêtes plus petites au lieu d’une seule grande requête. Par exemple, si vous devez mettre à jour les itinéraires de 1 000 propriétés, Microsoft peut vous envoyer 100 messages de requête de 10 propriétés chacun.