Anfragenachrichten

Anfragenachrichten sind Google-Anfragen zu Preis- oder Metadatenaktualisierungen. Sie werden mit den Übermittlungsmodi „Pull-Preise“ 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 Zimmern 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 Content-Type-Header auf „application/xml“ und der User-Agent-Header auf Google-HotelAdsPrices gesetzt ist. Die Ausnahme von dieser Regel tritt beim manuellen Testen der Integration des Preisendpunkts über Google-TravelAds-Live auf. Diese Beispielabfragen können den Header User-Agent enthalten, müssen dies aber nicht.

Detaillierte Formatierungen für Abfragenachrichten finden Sie in der XML-Referenz für Abfragen.

Nachrichten zu Preisanfragen

Preisabfragenachrichten enthalten die Unterkunfts- oder Reiseplankombinationen, 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 innerhalb eines bestimmten Zeitraums darauf reagieren müssen.

2. Mit Kontext:Wenn diese Option aktiviert ist, werden Kontextempfehlungen von Nutzern in jede von Google gesendete Abfrage aufgenommen. Die Empfehlungen spiegeln die häufigsten Nutzertypen wider, die nach den angegebenen Hotel- oder Reiseplankombinationen suchen. Wenn Sie diese Empfehlungen befolgen, können Sie Ihre Antworten effizienter gestalten.

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 Nutzersuchen. Google erhält von einem Nutzer eine Suchanfrage für ein Hotel oder eine Reiseplankombination. Da Preisdaten nicht verfügbar oder nicht aktuell sind, fordert Google zum Zeitpunkt der Suche eine Preisaktualisierung von Ihnen an. Bei Abfragen von Livepreisen versucht Google, einen Preis abzurufen und ihn in den Ergebnissen zum Zeitpunkt der Suche anzuzeigen.

Für alle Anfragen zu Livepreis-Abfragen gilt ein Zeitlimit von maximal 4.000 Millisekunden. Dieses Limit wird in der Anfrage zur Livepreisabfrage angegeben. Wenn innerhalb der Frist keine Antwort gegeben werden kann, verpasst du die entsprechende Gelegenheit. Wir empfehlen jedoch, trotzdem einen Preis anzugeben, damit er im Cache gespeichert und für zukünftige Möglichkeiten verwendet werden kann. Die Verbindung für die Antwort bleibt zehn Minuten oder wie in der Konfiguration des Partners angegeben geöffnet.

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 es sich bei diesen Gästen um Erwachsene oder Kinder handelt. Mit Livepreisabfragen können Sie aktuellere Preise anzeigen, die mit der Suchanfrage des Kunden übereinstimmen.

Livepreisabfragen sind ein sekundärer Mechanismus für Preisaktualisierungen. Der primäre Mechanismus für Preisneuberechnungen ist nach wie vor die Option „Pull-Preise“ oder „Geänderte Preise“. Mit Livepreisabfragen können Sie Lücken schließen, in denen Google keine Preise für Hotel- oder Reiseplankombinationen hat.

Wichtiger Hinweis :Aufgrund der neuen Suche ist Liveabfragen für Nutzer im EWR nicht mehr verfügbar.

Regeln für die Verwendung von Livepreisabfragen

• Im Cache sind keine Daten für den angegebenen Reiseplan vorhanden, weil der angeforderte Reiseplan atypisch ist, z. B. weil die Daten sehr weit in der Zukunft liegen oder nach dem Hotel nur 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 die Ergebnisse von Livepreisen in der Regel im Cache, damit dasselbe Hotel oder derselbe Reiseplan nicht noch einmal abgefragt wird. Es können sowohl einzelne Hotel- oder Reiseplankombinationen als auch Kombinationen aus mehreren Hotels oder einzelnen Reiseplänen angefordert werden.

Die Funktion Livepreise mit Kontext ermöglicht es Google, spezifische Anfragen zu Livepreisen basierend auf dem Gerätetyp eines Nutzers, dem Land, von dem aus er sucht, und der Anzahl der Personen, einschließlich Kindern, zu senden. Sowohl die Anfragenachricht als auch die Transaktionsnachricht werden um das Element <Context> erweitert, das die Abfrageparameter definiert. Von Livepreisabfragen mit Kontext erhaltene Preise 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 es sich um ein Land des Nutzers oder ein Nutzergerät handelt.

Mit Kontextabfragen

Kontextabfragen sind reguläre Anfragen zur Aktualisierung unserer Datenbank für die angegebenen Property- oder Reiseplankombinationen. Sie enthalten eine Liste von Nutzerkontexten, die für diese Kombinationen häufig verwendet werden. Wenn nutzerabhängige Preise verwendet werden, können die Gebühren für das Senden für alle 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.

Wichtiger Hinweis :Wenn Sie Anfragen vom Typ „With Context“ erhalten möchten, wenden Sie sich an Ihren Technical Account Manager (TAM). Er kann bestätigen, dass Sie für den Empfang solcher Nachrichten bereit sind, und dann eine Konfigurationsanpassung vornehmen, um Nutzerkontexte in Abfragen an Sie zu senden.

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 Sie die Preise für die angeforderten Unterkünfte in <Result>-Elementen angeben.

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

Abfragen steuern

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

Grenzen von Reiseplänen

Die möglichen Grenzen von Preisabfragen ermitteln Sie mit <ItineraryCapabilities>. 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. Diese Einstellungen lassen sich auch für Hotelgruppen definieren.

Beispiele für Anfragenachrichten

In diesem Abschnitt finden Sie mehrere Beispiele für Preisanfragenachrichten und eine Metadaten-Anfragenachricht. Weitere Beispiele finden Sie in der XML-Referenz für Abfragen.

Beispielreiseplan

Das folgende Beispiel zeigt ein Preis-<Query>-Element, über das Preisaktualisierungen für 4 Hotels für 3 Nächte 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 Zimmerinventar (Transaktionen).

Beispiel für eine Kontextabfrage

Das folgende Beispiel zeigt ein Beispiel für eine Abfrage mit Kontext:

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

Bei Kontextabfragen wird nur der Kontext 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 <Query>-Preisnachricht 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

Metadaten-Abfragenachricht

Im folgenden Beispiel sehen Sie eine <Query>-Nachricht, mit 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 werden. Weitere Informationen finden Sie unter Definieren von Zimmer- und Paketmetadaten.