Anfragenachrichten

Anfragenachrichten sind Google-Anfragen zu Preis- oder Metadatenaktualisierungen. Sie werden mit den Übermittlungsmodi „Pull“ und „Geänderte Preise“ verwendet.

Das Stammelement von Anfragenachrichten ist <Query>.

Die Struktur der Anfragenachricht hängt vom Nachrichtentyp ab:

  • Preise: Google fragt in einer Anfragenachricht Preisaktualisierungen für die angegebenen Hotels ab.

  • Metadaten: Google sendet eine Anfragenachricht, in der Daten zu den Zimmer- und Paketinformationen in den angegebenen Hotels angefordert werden.

Sie definieren den Endpunkt, den Google während der Erstkonfiguration für Anfragenachrichten und Livepreisabfragen verwendet. Weitere Informationen erhalten Sie von Ihrem Technical Account Manager (TAM).

Google sendet eine Anfragenachricht als HTTP-POST-Anfrage, wobei der Header Content-Type auf „application/xml“ und der Header User-Agent auf Google-HotelAdsPrices gesetzt ist. Die Ausnahme von dieser Regel tritt beim manuellen Testen der Einbindung des Preisendpunkts über Google-TravelAds-Live auf. Diese Beispielabfragen können den Header User-Agent enthalten.

Detaillierte Informationen zur Formatierung von Anfragenachrichten finden Sie in der XML-Referenz für Abfragen.

Preisabfragenachrichten

Preisanfragenachrichten geben die Hotel- oder Reiseplankombinationen an, für die Sie Preise angeben.

Wenn Ihr Server eine Anfragenachricht für pricing erhält, sollte er mit einer <Transaction>-Nachricht mit den angeforderten Preisinformationen antworten.

Weitere Informationen finden Sie in der Preisübersicht.

Es gibt drei spezielle Arten von Anfragenachrichten:

  1. Livepreise:Wenn diese Option aktiviert ist, werden Abfragen gesendet, wenn ein Nutzer aktiv nach Preisen für die angegebene Unterkunft oder Reiseplankombination sucht und Sie einen bestimmten Zeitraum zum Antworten haben.

  2. Mit Kontext:Wenn diese Option aktiviert ist, werden Nutzerkontextempfehlungen in jede von Google gesendete Abfrage einbezogen. Die Empfehlungen spiegeln die häufigsten Arten von Nutzern wider, die nach den jeweiligen Kombinationen aus Unterkünften oder Reiseplänen suchen. Wenn Sie diese Empfehlungen befolgen, können Sie die Effizienz Ihrer Antworten steigern.

  3. Metadaten: Dies ist eine Anfrage für Details zu Zimmern und Paketen für die angegebenen Unterkünfte.

Livepreisabfragen

Livepreisabfragen sind Anfragen von Google nach Preisaktualisierungen in Echtzeit als Reaktion auf Suchanfragen von Nutzern. Google erhält eine Suchanfrage von einem Nutzer für ein Hotel oder einen Reiseplan. Da Preisdaten nicht verfügbar oder nicht aktuell sind, fordert Google zum Zeitpunkt der Suche eine Preisaktualisierung von Ihnen an. Bei Livepreisabfragen versucht Google, einen Preis abzurufen und ihn in den Ergebnissen zum Zeitpunkt der Suche anzuzeigen.

Für alle Anfragen zu Livepreisen gilt ein Zeitlimit von in der Regel bis zu 4.000 Millisekunden. Dieses Limit wird in der Anfrage zur Livepreisabfrage angegeben. Wenn innerhalb der Frist keine Antwort gegeben werden kann, wird die Teilnahme an der jeweiligen Gelegenheit verpasst. Wir empfehlen jedoch, einen Preis trotzdem anzugeben, damit er im Cache gespeichert und für zukünftige Empfehlungen verwendet werden kann. Die Verbindung für die Antwort bleibt zehn Minuten lang oder wie in der Konfiguration des Partners angegeben offen.

Livepreisabfragen sind außerdem kontextabhängig und können Preise für die folgenden Parameter abrufen: Land des Nutzers, Gerätetyp, Belegung (Anzahl der Gäste) und ob diese Gäste Erwachsene oder Kinder sind. Mit Livepreisabfragen können Sie aktuellere Preise anzeigen, die mit der Suchanfrage des Kunden übereinstimmen.

Livepreisabfragen sind als sekundäres Mechanismus für Preisaktualisierungen gedacht. Der primäre Mechanismus für Preisneuberechnungen ist nach wie vor die Option „Pull-Preise“ oder „Geänderte Preise“. Livepreisabfragen helfen, die Lücken zu füllen, in denen Google keine Preise für Hotel- oder Reiseplankombinationen zur Verfügung hat.

Regeln für die Verwendung von Livepreisabfragen

  • Für den angegebenen Reiseplan sind keine Daten im Cache vorhanden, da der angeforderte Reiseplan atypisch ist, z. B. Daten, die sehr weit in der Zukunft liegen, oder nach dem Hotel sehr selten gesucht wird.

  • Das angeforderte Datum ist kein Standarddatum.

Hinweis: Die Standarddaten können bei Livepreisabfragen nicht berücksichtigt werden. Livepreisabfragen werden nur für nicht standardmäßige Zeiträume angefordert.

Google speichert in der Regel die Ergebnisse von Livepreisen im Cache, damit dasselbe Hotel oder derselbe Reiseplan nicht noch einmal abgefragt wird. Sie können sowohl einzelne Hotels oder Reiseplankombinationen als auch Kombinationen mit mehreren Hotels oder Reiseplänen anfordern.

Mit der Funktion Livepreise mit Kontext kann Google bestimmte Livepreisanfragen basierend auf dem Gerätetyp eines Nutzers, dem Land, von dem aus er sucht, und der Anzahl der Personen, einschließlich Kindern, senden. Sowohl die Anfragenachricht als auch die Transaktionsnachricht werden um das Element <Context> erweitert, das die Abfrageparameter definiert. Preise, die von Livepreisabfragen mit Kontext empfangen werden, können als Zimmerpaket im Cache gespeichert werden, wenn es sich um einen Preis für eine bestimmte Belegung handelt, und als nutzerabhängiger Preis, wenn er für das Land eines Nutzers oder ein Nutzergerät gilt.

Mit Kontextabfragen

Kontextabfragen sind reguläre Anfragen zur Aktualisierung unserer Datenbank für die angegebenen Kombinationen von Unterkünften oder Reiseplänen. Sie enthalten eine Liste von Nutzerkontexten, die für diese Kombinationen beliebt sind. Wenn nutzerabhängige Preise verwendet werden, können die Gebühren für das Senden aller möglichen Nutzerkontexte teuer sein. Daher können Sie diese Liste von Nutzerkontexten verwenden, um Ihre Antwort einzuschränken. Die Rückgabe von Preisen nur für die angegebenen Nutzerkontexte deckt die überwiegende Mehrheit der relevanten Nutzeranfragen ab.

Metadaten-Abfragenachrichten

Metadatenabfragenachrichten enthalten Details zu Zimmer- und Paketinformationen für die angegebenen Unterkünfte.

Wenn Sie eine Anfragenachricht zu Metadaten erhalten, sollten Sie mit einer <Transaction>-Nachricht antworten, in der die Preise für die angeforderten Unterkünfte in <Result>-Elementen angegeben sind.

Weitere Informationen finden Sie unter Definieren von Zimmer- und Paketmetadaten.

Abfragen steuern

In diesem Abschnitt wird beschrieben, wie Sie festlegen, welche Unterkünfte und Reisepläne Gegenstand von Anfragenachrichten von Google sein können.

Grenzen von Reiseplänen

Die möglichen Grenzen von Preisabfragen legen Sie mit <ItineraryCapabilities> fest. Sie definieren Regeln, die den Zeitraum und die maximale Aufenthaltsdauer festlegen, die Sie unterstützen.

Sie können für <MaxAdvancePurchase> und <MaxLengthOfStay> Standardwerte festlegen, die für alle Hotel- oder Reiseplankombinationen gelten. Sie können diese Einstellungen auch für Hotelgruppen definieren.

Beispiele für Anfragenachrichten

Dieser Abschnitt enthält mehrere Beispiele für Preisanfragenachrichten und eine Metadaten-Abfragenachricht. Weitere Beispiele finden Sie in der XML-Referenz für Abfragen.

Beispielreiseplan

Im folgenden Beispiel sehen Sie eine Preis-<Query>, mit der Preisaktualisierungen für vier Hotels für drei Übernachtungen ab dem 23. Mai 2023 angefragt werden:

<?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>

In diesem Beispiel werden Preisaktualisierungen für jedes Hotel angefordert:

5/23/18 - 6/26/18

Beispiel für eine Livepreisabfrage

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

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

In diesem Beispiel wird ein Preis für ein einzelnes Hotel angefordert:

6/23/23 - 6/25/23

Ein Beispiel für eine Transaktionsnachrichtenantwort auf diese Abfrage finden Sie in der XML-Referenz für Preise und Inventar (Transaktionen).

Beispiel mit Kontextabfrage

Das folgende Beispiel zeigt ein Beispiel 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>

Mit Kontextabfragen wird nur der Kontext des Nutzers im Land des Nutzers angegeben. In Zukunft könnten solche Abfragen auch das Gerät und die Belegung des Nutzers angeben.

Check-in-Zeiträume

Wenn Sie „Geänderte Preise“ verwenden, hängt die Struktur der Abfragenachricht vom Hinweistyp ab, den Sie für Check-in-Zeiträume, genaue Reisepläne oder Reisepläne mit bestimmten Zeiträumen verwenden. Weitere Informationen zu jedem dieser Hinweistypen finden Sie unter Hinweisantwortnachrichten.

Das folgende Beispiel zeigt eine Preis-<Query>-Nachricht für Check-in-Zeiträume:

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

In diesem Beispiel werden Preisaktualisierungen für die folgenden Aufenthalte (für jedes Hotel) angefordert:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

Aufenthalte in bestimmten Zeiträumen

Das folgende Beispiel zeigt eine Preisnachricht <Query> für Aufenthalte in bestimmten Zeiträumen:

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

In diesem Beispiel werden Preisaktualisierungen für jedes Hotel angefordert:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

Außerdem werden Aufenthalte angefordert, deren Startdatum vor dem gegebenen Datum liegen, dieses aber beinhalten:

5/20/23 - 5/23/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

Metadatenabfragenachricht

Im folgenden Beispiel sehen Sie eine <Query>-Nachricht, in der Metadatenaktualisierungen für die Zimmer- und Paketinformationen für mehrere Unterkünfte angefordert werden:

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

Sie antworten auf diese Art von Anfragenachricht mit einer Transaktionsnachricht, in der Zimmer- und Paketmetadaten definiert sind. Weitere Informationen finden Sie unter Definieren von Zimmer- und Paketmetadaten.