Abfrage-XML-Referenz für Hinweise

Dieser Abschnitt enthält eine Referenz für die Google XML-basierten Hinweisanfragenachrichten, Hinweisantwortnachrichten und Anfragenachrichten.

<Hint> (Hinweisantwortnachricht)

Das Stammelement einer Hinweisantwortnachricht. In Hinweisantwortnachrichten wird angegeben, für welche Hotel-/Reiseplan-Kombinationen Preise aktualisiert werden sollen. Sie sind Ihre Antwort auf eine Hinweisanfragenachricht von Google.

In einer Hinweisantwortnachricht sollten nur die Hotels angegeben werden, deren Preise sich geändert haben, seit Google die letzte erfolgreiche Hinweisantwort von Ihren Servern erhalten hat.

In Hinweisantwortnachrichten wird mit einer der folgenden Methoden angegeben, für welche Hotels und Reisepläne Google die Preise aktualisieren soll:

  • Exakte Reisepläne: Eine Kombination aus Check-in-Datum und Aufenthaltsdauer.

  • Check-in-Zeiträume: Gibt einen Check-in-Zeitraum an, der mit dem ersten Check-in-Datum beginnt und mit dem letzten Check-in-Datum endet.

  • Aufenthalte in bestimmten Zeiträumen (oder Reisepläne mit bestimmten Zeiträumen)

Jede dieser Methoden erfordert eine andere Syntax für die Hinweisantwortnachricht.

Weitere Informationen finden Sie unter Hinweisantwortnachrichten.

Syntax

Das <Hint>-Element verwendet je nach Typ der Hinweisantwortnachricht eine andere Syntax:

Genaue Reisepläne

Im Folgenden sehen Sie die Syntax für genaue Reisepläne in einer Hinweisantwortnachricht:

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>hotel_ID</Property>
    ...
    <Stay>
      <CheckInDate>checkin_date</CheckInDate>
      <LengthOfStay>number_of_nights</LengthOfStay>
    </Stay>
  </Item>
  ...
</Hint>

Check-in-Zeiträume

Im Folgenden sehen Sie die Syntax für Check-in-Zeiträume in einer Hinweisantwortnachricht:

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <!-- Can be > 1 if MultipleItineraries is "checkin_range" in your
         QueryControl message -->
    <Property>hotel_ID</Property>
    [...]

    <!-- Required -->
    <FirstDate>first_checkin_date</FirstDate>
    <!-- Required -->
    <LastDate>last_checkin_date</LastDate>
  </Item>
  ...
</Hint>

Aufenthalte in bestimmten Zeiträumen

Im Folgenden sehen Sie die Syntax für Aufenthalte in bestimmten Zeiträumen in einer Hinweisantwortnachricht:

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <!-- Can be > 1 if MultipleItineraries is "affected_dates" in your
         QueryControl message -->
    <Property>hotel_ID</Property>
    [...]

    <StaysIncludingRange>
      <!-- Required -->
      <FirstDate>first_date</FirstDate>

      <!-- Optional -->
      <LastDate>last_date</LastDate>
    </StaysIncludingRange>
  </Item>
  ...
</Hint>

Attribute

Das <Hint>-Element enthält ein optionales Attribut: id. Sofern angegeben, wird sie als hintId-Attribut in <Query>-Nachrichten eingeschlossen, die basierend auf diesem <Hint> gesendet werden.

Untergeordnete Elemente

Das <Hint>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element Erforderlich? Typ Hinweisantworttyp Beschreibung
<CheckInDate> Required Date Genaue Reisepläne Das Check-in-Datum für den Reiseplan.
<FirstDate> Required Date Check-in-Zeiträume und Reisepläne mit bestimmten Zeiträumen Das erste Datum des Zeitraums für eine Hinweisantwortnachricht für einen Check-in-Zeitraum oder einen Aufenthalt in bestimmten Zeiträumen. Die Datumsangaben sind inklusive.
<Item> Required Object Alle Ein Container für das zu aktualisierende Hotel/den zu aktualisierenden Reiseplan.
<LastDate> Required* Date Check-in-Zeiträume und Reisepläne mit bestimmten Zeiträumen

Das letzte Datum des Zeitraums für eine Hinweisantwortnachricht für einen Check-in-Zeitraum oder einen Aufenthalt in bestimmten Zeiträumen. Die Datumsangaben sind inklusive.

* Dieses Element ist für Aufenthalte in bestimmten Zeiträumen optional.
<LengthOfStay> Required integer Genaue Reisepläne Die Anzahl der Übernachtungen des Reiseplans als positive Ganzzahl.
<Property> Required string Alle

Die ID eines Hotels mit derselben ID wie die Hotelliste. Wie viele <Property>-Elemente in einem einzelnen <Item>-Block angegeben werden können, hängt von der Art der Hinweisantwortnachricht ab:

  • Genaue Reisepläne: Bis zu 100 Hotels.
  • Check-in-Zeiträume: mehrere, wenn Sie <MultipleItineraries> in Ihrer <QueryControl>-Nachricht auf "checkin_range" gesetzt haben.
  • Aufenthalt in bestimmten Zeiträumen: mehrere, wenn Sie <MultipleItineraries> in Ihrer <QueryControl>-Nachricht auf "affected_dates" gesetzt haben.
<Stay> Required Object Genaue Reisepläne Ein Container für die Elemente <CheckinDate> und <LengthOfStay> in einer Hinweisantwortnachricht für genaue Reisepläne. Jedes <Item> kann nur ein einziges <Stay> enthalten.
<StaysIncludingRange> Required Object Reisepläne mit bestimmten Zeiträumen Ein Container für die Elemente <FirstDate> und <LastDate> in einer Hinweisantwortnachricht für Aufenthalte in bestimmten Zeiträumen.

Beispiele

Genaue Reisepläne

Im folgenden Beispiel werden mehrere Reisepläne für ein einzelnes Hotel in einer Hinweisantwortnachricht definiert:

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>4</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Check-in-Zeiträume

Im folgenden Beispiel werden zwei Hotels angegeben, deren Preise sich geändert haben und noch einmal abgerufen werden sollten. Google ruft alle Reisepläne für die Unterkünfte 12345 bis 67890 zwischen dem 3. und 6. Juli ab:

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Property>67890</Property>
    <FirstDate>2018-07-03</FirstDate>
    <LastDate>2018-07-06</LastDate>
  </Item>
</Hint>

Damit eine Nachricht für den Check-in-Bereich mehrere Unterkünfte in einer einzelnen <Item> angeben kann, muss der Wert von <MultipleItineraries> in <QueryControl> auf "checkin_range" festgelegt werden.

Aufenthalte in bestimmten Zeiträumen

Das folgende Beispiel zeigt zwei verschiedene Verwendungen von Aufenthalten in bestimmten Zeiträumen, eine für eine Reihe von Übernachtungen und eine für eine einzelne Nacht:

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <!-- Google fetches prices for all itineraries (first and last date are set) -->
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
      <LastDate>2018-07-06</LastDate>
    </StaysIncludingRange>
  </Item>

  <!-- Google fetches prices for a single night (first date only) -->
  <Item>
    <Property>67890</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Damit für eine Nachricht für einen Aufenthalt in bestimmten Zeiträumen mehrere Unterkünfte in einer einzelnen <Item> angegeben werden können, muss der Wert von <MultipleItineraries> in <QueryControl> auf "affected_dates" festgelegt werden.

Auf jedes dieser Beispiele antwortet Google mit einem <Query>. Anschließend sollten Sie mit einem <Transaction> antworten, das Preisaktualisierungen für die angegebenen Hotels/Reisepläne enthält.

<HintRequest>

Das Stammelement einer Hinweisanfragenachricht. Google sendet eine Hinweisanfragenachricht an Ihren Server und erwartet eine Antwort mit den Hotels und Reiseplänen, deren Preise sich seit der letzten erfolgreichen Hinweisantwort durch Google geändert haben.

Bei Preisänderungen sendet Google eine <Query>, die die aktualisierten Preisdaten für die angegebenen Hotels und Reisepläne abruft.

Weitere Informationen finden Sie unter Hinweisanfragenachrichten.

Syntax

Das <HintRequest>-Element verwendet die folgende Syntax:

Syntax

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest>
  <LastFetchTime>last_fetch_time</LastFetchTime>
</HintRequest>

Attribute

Das <HintRequest>-Element hat keine Attribute.

Untergeordnete Elemente

Das <HintRequest>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element Typ Beschreibung
<LastFetchTime> DateTime Das letzte Mal, dass Google eine Hinweisantwortnachricht auf eine Hinweisanfragenachricht erhalten hat.

Wenn dieser Zeitpunkt vor der letzten Aktualisierung der Preise auf Ihrem Server liegt, sollten Sie mit einer Hinweisantwortnachricht antworten, in der angegeben ist, welche Hotels geändert wurden.

Wenn in letzter Zeit kein erfolgreicher Abruf erfolgt ist, wird ein fester Intervallwert festgelegt, um schwerwiegendere Probleme mit großen Rückständen zu vermeiden. Der aktuelle Wert für ein festes Intervall beträgt 1.000 Sekunden. Der Wert kann sich jedoch ändern.

Weitere Informationen finden Sie unter Hinweisantwortnachrichten.

Beispiele

Das folgende Beispiel zeigt eine Hinweisanfragenachricht:

Hinweisanfragenachricht

Das folgende Beispiel zeigt eine Hinweisanfragenachricht:

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="ABCDEF" timestamp="2018-06-07T16:20:00Z">
  <LastFetchTime>2018-03-25T00:04:09Z</LastFetchTime>
</HintRequest>

<Query>

Das Stammelement einer Query-Nachricht. Query-Nachrichten sind Anfragen von Google zu Preis- oder Metadatenaktualisierungen. Sie werden mit den Übermittlungsmodi „Pull“ und „Geänderte Preise“ verwendet.

Es gibt drei Arten von Query-Nachrichten:

  • Livepreise:Google reagiert auf eine bestimmte Nutzeranfrage und bittet um eine Preisaktualisierung in Echtzeit. Wenn Partner eine Live pricing query-Nachricht erhalten, sollten sie mit einer <Transaction>-Nachricht antworten, die die angeforderten Preisinformationen in <Result>-Elementen enthält.

  • Mit Kontextpreisen:Google aktualisiert seinen Preis-Cache anhand von Kontexten, die in der Vergangenheit beliebt waren. Wenn Sie eine With context query-Nachricht erhalten, sollten Sie mit einer <Transaction>-Nachricht antworten, die die angeforderten Preisinformationen in <Result>-Elementen enthält.

  • Metadaten: Google fordert Metadatenaktualisierungen für die Zimmer und Zimmerpakete der angegebenen Hotels an. Wenn Sie eine Metadata Query-Nachricht erhalten, sollten Sie mit einer <Transaction>-Nachricht antworten, in der Daten zu den Zimmern und Zimmerpaketen in <PropertyDataSet>-Elementen angegeben sind.

Weitere Informationen finden Sie in der Preisübersicht für Preisabfragen und in der Preisübersicht für Zimmerpakete für Metadatenabfragen.

Die Syntax für die drei verschiedenen Typen wird nachfolgend beschrieben.

Syntax

Das <Query>-Element verwendet die folgende Syntax:

Livepreise

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
  <!-- See documentation below for <Context> -->
  <Context>
   ...
  </Context>
</Query>

Mit Kontext

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyContextList>
    <PropertyContext>
      <Property>hotel_id</Property>
      ...
      <!-- See documentation below for <Context> -->
      <Context>
      ...
      </Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

Metadaten

<HotelInfoProperties>
  <Property>property_ID</Property>
  ...
</HotelInfoProperties>

Attribute

Das <Query>-Element kann ein Attribut enthalten: latencySensitive.

Das Attribut latencySensitive ist optional. Wenn dieses Flag angegeben und auf true gesetzt ist, bedeutet dies, dass die Abfrage ein Live Pricing Query ist. Wenn Google Abfragen mit dem Attribut latencySensitive senden soll, wenden Sie sich an Ihren Technical Account Manager (TAM).

Untergeordnete Elemente

Das <Query>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element Abfragetyp Typ Beschreibung
<AffectedNights> Pricing integer Die Anzahl der Übernachtungen für einen Aufenthalt in einem bestimmten Zeitraum. Dieses Element wird nur für Preisabfragen in einem bestimmten Zeitraum verwendet, die mit „Geänderte Preise“ verwendet werden.
<Checkin> Pricing Date Das Datum einer bestimmten Preisänderung.
<Context> Pricing (Live Pricing Queries only) <Context> Gibt für Livepreisabfragen bestimmte Parameter an, unter denen die Abfrage durchgeführt wird. Zu den untergeordneten Elementen gehören:
  • <Occupancy>: die Gesamtzahl der Gäste
  • <OccupancyDetails>: die Art der Gäste, z. B. Erwachsene oder Kinder
  • <UserCountry>: Land, in dem sich der Nutzer befindet
  • <UserDevice>: der Gerätetyp, auf dem der Gast nach einem Hotel gesucht hat, z. B. "mobile, „tablet“ oder „desktop“.

Das Element <Context> kann in einer einzelnen Anfrage wiederholt werden, sodass Abfragen für verschiedene Belegungen möglich sind. Eine Liste der untergeordneten Elemente, der Syntax und Beispiele finden Sie unter <Context>.
<FirstDate> Pricing Date Das Startdatum einer Reihe von Reiseplänen, für die der Preis gilt. Dieses Element wird nur für Preisabfragen für den Check-in-Zeitraum im Modus „Geänderte Preise“ verwendet.
<HotelInfoProperties> Metadata string Eine oder mehrere Unterkünfte, für die Google aktualisierte Zimmer- und Zimmerpaketmetadaten in einer Query-Metadatennachricht möchte. Dieses Element kann ein oder mehrere <Property>-Elemente enthalten, die Hotelunterkunfts-IDs angeben.
<LastDate> Pricing Date Das Enddatum einer Reihe von Reiseplänen, auf die der Preis angewendet wird. Dieses Element wird nur für Preisabfragen für den Check-in-Zeitraum im Pull-Modus mit Hinweisen verwendet.
<Nights> Pricing integer Die Anzahl der Übernachtungen für einen bestimmten Reiseplan (maximal 30).
<PropertyList> Pricing Object

Eine oder mehrere IDs für Hotels, für die Preisaktualisierungen erforderlich sind.

Definieren Sie jedes Hotel in einem <Property>-Element. Der Wert ist ein String, der einer Hotel-ID in Ihrer Hotelliste entspricht. Beispiel:

<PropertyList>
  <Property>pid1</Property>
  <Property>pid2</Property>
</PropertyList>

Beispiele

Preisabfrage

Das folgende Beispiel zeigt eine Preisanfragenachricht, mit der Preisaktualisierungen für eine Reihe von Hotels angefordert werden, die drei Nächte lang ab dem 10. Juni 2018 verfügbar sind:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

Livepreisabfrage

Das folgende Beispiel zeigt eine Livepreisabfrage mit einer Antwortzeit von 500 Millisekunden:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="8"/>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

Mit Kontextabfrage

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

Metadatenabfrage

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

Weitere Beispiele, etwa Abfragen für Aufenthalte und Check-in-Zeiträume in bestimmten Zeiträumen, finden Sie in den Beispielen für Nachrichten mit Query.

<Context>

Mit dem Element <Context> werden Informationen zu einer Live pricing query beschrieben, einschließlich Anzahl und Art der Gäste, Land des Nutzers und Gerät des Nutzers.

Mehrere <Context> werden nie mit unterschiedlichen Nutzerländern oder Nutzergeräten verwendet. Wenn für die Abfrage mehrerer Belegungen mehrere <Context> verwendet werden, geben Sie jeden Belegungspreis als zusätzliches Zimmerpaket für das entsprechende Hotel/den entsprechenden Reiseplan an. Jede Unterkunft bzw. jeder Reiseplan sollte einen einzelnen <Result>-Block haben, in dem die Preise für mehrere Belegungen enthalten sind.

Die Antwortdetails für die <Context>-Abfrage finden Sie unter <OccupancyDetails>.

Syntax

Das <Context>-Element verwendet die folgende Syntax:

Syntax

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>date</Checkin>
  <Nights>number_of_nights</Nights>
  <DeadlineMs>number_of_milliseconds</DeadlineMs>
  <PropertyList>
    <Property>property_ID</Property>
  </PropertyList>
  <Context>
  <Occupancy>total_number_of_guests</Occupancy>
  <OccupancyDetails>
    <NumAdults>number_of_adults</NumAdults>
    <Children>
      <Child age=age_of_one_child_guest/>
      <Child age=age_of_one_child_guest/>
    </Children>
  </OccupancyDetails>
  <UserCountry>end_user_country</UserCountry>
  <UserDevice>user_device_type</UserDevice>
  </Context>
</Query>

Untergeordnete Elemente

Das <Context>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element Abfragetyp Typ Beschreibung
<Occupancy> Pricing integer Gibt die Gesamtzahl der Gäste an.

Obwohl Abfragen mit <Occupancy> nicht obligatorisch sind, sollten sie zu einer Transaktionsnachricht führen, in der die entsprechenden Zimmerpakete für jede abgefragte <Occupancy> definiert sind.

Hinweis:<Occupancy> wird möglicherweise nicht immer in einer Abfrage angezeigt. In diesen Fällen sollten Sie die Preise für alle Belegungen zurückgeben.
<OccupancyDetails> Pricing Object <Occupancy> ist vorangestellt. Gibt Gäste nach Typ an, einschließlich:

  • <NumAdults>: Anzahl der erwachsenen Gäste
  • <Children> und <Child="age">: Gibt an, welche Gäste Kinder sind (in der Regel zwischen 0 und 17 Jahren). Enthält optional das Alter der einzelnen Kinder.

    • Obwohl Abfragen mit <OccupancyDetails> nicht obligatorisch sind, sollten sie zu einer Transaktionsnachricht führen, in der die entsprechenden Zimmerpakete für jede abgefragte <Occupancy> definiert sind.

    Hinweis: <OccupancyDetails> wird möglicherweise nicht immer in einer Abfrage angezeigt. In diesen Fällen sollten Sie davon ausgehen, dass alle Gäste erwachsen sind.
<UserCountry> Pricing string

Filtert Preise nach dem Land, in dem sich der Nutzer befindet. Der Wert ist ein zweistelliger Ländercode wie “US” für die USA oder ein Regionscode wie "EU" für „Europa“.

Abfragen mit definiertem <UserCountry> sollten zu einer Transaktionsnachricht führen, in der der entsprechende <Rates>-Block für das abgefragte Land definiert ist.
<UserDevice> Pricing string

Filtert Preise nach dem Typ des Geräts, von dem aus der Nutzer sucht. Mögliche Werte:

  • mobile
  • desktop
  • tablet

Abfragen mit definiertem <UserDevice> sollten zu einer Transaktionsnachricht führen, in der der entsprechende <Rates>-Block für den abgefragten Gerätetyp definiert ist.

Beispiele

Anwesenheit

Das folgende Beispiel zeigt eine Livepreisabfrage für <Occupancy> in <Context>. Die Livepreisabfrage gilt für 3 Erwachsene.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

Belegungsdetails

Das folgende Beispiel zeigt eine Livepreisabfrage mit <OccupancyDetails> in <Context>. Die Livepreisabfrage bezieht sich auf 4 Gäste, von denen 2 Kinder sind, und sucht nach einem Preis, der für die Buchung eines Gasts in den USA über ein Mobilgerät gilt:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="4"/>
        <Child age="12"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

Mehrere Kontexte

Das folgende Beispiel zeigt die Verwendung eines zusätzlichen <Context>-Elements in einer Livepreisabfrage.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
  <Context>
    <Occupancy>6</Occupancy>
    <OccupancyDetails>
      <NumAdults>4</NumAdults>
      <Children>
        <Child age="6"/>
        <Child age="10"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>