Hinweisantwortnachrichten

Wenn Google eine Hinweisanfragenachricht sendet, sollten Ihre Server eine Hinweisantwortnachricht zurücksenden, in der die Hotels angegeben sind, deren Preise sich seit der zuletzt von Google erhaltenen Hinweis Antwort geändert haben. Wenn Preise geändert wurden, ruft Google die aktualisierten Preisdaten für die angegebenen Hotels und Reisepläne in einer <Query> ab.

Eine Übersicht über den Prozess der Preisänderung finden Sie unter Preisübersicht.

**Wichtig**: Wenn Sie „Geänderte Preise“ nicht implementieren, ruft Google Daten für alle Hotels in Ihrer Hotelliste ab.

In Hinweisantwortnachrichten werden die folgenden Methoden verwendet, um die Preise für die ausgewählten Hotels und ihre Reisepläne zu aktualisieren:

• Genaue Reisepläne
• Check-in-Zeiträume
• Aufenthalte in bestimmten Zeiträumen

**Hinweis**: Die Standardaufenthaltsdauer bei Verwendung von „Geänderte Preise“ beträgt 30 Tage.

Das Stammelement einer Hinweisantwortnachricht ist <Hint>. Sie fordern die Aktualisierung eines Hotels oder Reiseplans mit einem oder mehreren <Item>-Elementen an. Eine Hinweis antwortnachricht kann beliebig viele <Item>-Elemente enthalten.

In jeder Hinweisantwortnachricht muss mindestens ein <Property>-Element für jedes <Item> angegeben sein. Das <Property> identifiziert ein Hotel, indem es dieselben IDs wie die Hotelliste verwendet. Standardmäßig geben Sie für jeden <Item> Block eine Hotel-ID an. Sie können Google jedoch anweisen, mehrere Hotels in einem Elementblock zuzulassen, wenn Sie für Preisaktualisierungen Check-in-Zeiträume oder Aufenthalte in bestimmten Zeiträumen verwenden.

Anfrage- und Antwortzyklus für genaue Reisepläne

Hinweisnachrichten können auf individuellen Reiseplänen basieren, z. B. auf der Kombination aus Check-in-Datum und Aufenthaltsdauer. In diesem Fall geben Sie ein Check-in-Datum und die Aufenthaltsdauer für Ihre Hotels an. Google ruft daraufhin nur die neuen Preisdaten für diesen Reiseplan ab.

Antwort des Partners

In der folgenden Hinweisantwortnachricht werden ein einzelnes Hotel und ein einzelner Reiseplan angegeben:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Antwort von Google

Google reagiert auf Ihre Hinweisantwortnachricht mit einer <Query> wie der folgenden:

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

<Transaction> erstellen

Google erwartet daraufhin von Ihnen, dass Sie eine <Transaction> mit Preisaktualisierungen für das Hotel für den folgenden Aufenthalt erstellen:

5/20/23 - 5/23/23

Anfrage- und Antwortzyklus für Check-in-Zeiträume

In einer Hinweisantwortnachricht kann ein Check-in-Zeitraum angegeben werden, der mit dem ersten Check-in-Datum beginnt und mit dem letzten Check-in-Datum endet. Zum Abrufen neuer Preisdaten ruft Google die Reisepläne für das Hotel für alle Check-in-Tage innerhalb dieses Zeitraums mit der von Ihnen angegebenen Aufenthaltsdauer ab.

Zeiträume des Partners

Im folgenden Beispiel für eine Hinweisantwortnachricht wird ein einzelnes Hotel mit einem Check-in-Zeitraum angegeben:

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

Antwort von Google

Google reagiert auf diese Hinweisantwortnachricht mit <Query> ähnlich wie der folgenden:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

<Transaction> erstellen

Google erwartet daraufhin von Ihnen, dass Sie eine <Transaction> mit Preisaktualisierungen für dieses Hotel und die folgenden Aufenthalte erstellen:

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 diesem Beispiel beträgt die Aufenthaltsdauer 5 Tage. Die Standardaufenthaltsdauer beträgt 30 Tage.

Anfrage- und Antwortzyklus für Aufenthalte in bestimmten Zeiträumen

Eine Hinweisantwortnachricht kann einen Zeitraum mit geänderten Preisen enthalten. Dadurch wird Google informiert, dass alle Reisepläne abgerufen werden sollen, die von einem dieser Daten betroffen sind. Die tatsächlich abgerufenen Reisepläne hängen von den Daten mit Änderungen und der maximalen Aufenthaltsdauer ab.

Aufenthalte in bestimmten Zeiträumen des Partners

In der folgenden Hinweisantwortnachricht werden Aufenthalte mit bestimmten Zeiträumen angegeben:

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Antwort von Google

Google reagiert auf Ihre Hinweisantwortnachricht mit einer <Query> wie der folgenden:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

<Transaction> erstellen

Google erwartet daraufhin von Ihnen, dass Sie eine <Transaction> mit Preisaktualisierungen für das Hotel für die folgenden Aufenthalte erstellen:

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

Hinweis: Bei Aufenthalten in bestimmten Zeiträumen müssen die Preise aller Reisepläne aktualisiert werden, einschließlich derer, die vor dem ersten Datum beginnen und derer, die dieses Datum enthalten.

Aufenthalte in bestimmten Zeiträumen: Batching-Limits und Aufteilung von Abfragen

Google begrenzt jede Pull-Abfrage auf maximal 10.000 Kombinationen aus Hotel und Reiseplan (ein Hotel, ein Check-in-Datum und eine Aufenthaltsdauer). Bei einem Hinweis zu einem Aufenthalt in einem bestimmten Zeitraum wird die Anzahl der Kombinationen mit der Trapezformel berechnet, um die Anzahl der Kombinationen aus Hotel und Reiseplan für Abfragen zu Aufenthalten in bestimmten Zeiträumen zu ermitteln:

$$ \text{Total Items} = \left( \text{Date Span} \times \text{LOS} + \frac{\text{LOS} \times (\text{LOS} + 1)}{2} \right) \times N_{\text{hotel_batch_size}} $$

Wobei:

• Date Span: Die Anzahl der Tage zwischen <FirstDate> und <LastDate> einschließlich (Date Span = LastDate – FirstDate + 1).
• LOS: Die maximale Aufenthaltsdauer, die im Hinweis angefordert wird (z. B. <AffectedNights>14</AffectedNights>).
• \(N_{\text{hotel_batch_size}}\): Die Anzahl der Hotels, die im Abfragebatch enthalten sind (konfiguriert über hotel_batch_size).

Was passiert,wenn ein Hinweis mehr als 10.000 Elemente enthält?

Wenn die berechnete Anzahl der Elemente 10.000 übersteigt, teilt Google die Abfragelast automatisch auf:

1. Erster Versuch (Aufenthalt in einem bestimmten Zeitraum): Ein kleinerer Zeitraum, der den Anfang Ihres Zeitraums abdeckt, wird mit <AffectedNights> gesendet.
2. Erster Fallback (falls unterstützt – Check-in-Zeitraum): Wir versuchen, kleinere Restzeiträume als Abfragen für Check-in-Zeiträume mit <Nights> zu senden (siehe Abfrage unten).
3. Letzter Fallback (genaue Reisepläne): Wir erweitern die Abfrage auf die einzelnen genauen Reisepläne.

<!-- Example: Remainder batch dispatched after a split -->
<Query>
  <FirstDate>2026-10-01</FirstDate>
  <LastDate>2026-10-31</LastDate>
  <Nights>14</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Empfohlene Vorgehensweisen, um eine unbeabsichtigte Herabstufung von Abfragen zu vermeiden

• Batchgrößen für Hotels ausgleichen: Wenn Sie große Zeiträume (z. B. 180 bis 365 Tage) mit Aufenthaltsdauern von 14 oder mehr Tagen aktualisieren, bitten Sie Ihren technischen Kundenbetreuer bei Google, den Wert für hotel_batch_size zu verringern, damit Hinweise keine Aufteilung auslösen.
• Hinweise genau eingrenzen: Wenn Sie Google über Preisänderungen informieren, beschränken Sie die Zeiträume für <FirstDate> und <LastDate> auf die spezifischen Zeiträume, in denen sich die Preise tatsächlich geändert haben, anstatt ein volles Kalenderjahr zu senden.
• Wenn Ihre Hinweise große Zeiträume abdecken: Achten Sie darauf, dass Ihr Parser entweder oder in -Blöcken akzeptiert, die <FirstDate> und <LastDate> enthalten, damit mehrere Abfragetypen für Zeiträume verwendet werden können, um die Pull-Anfragen zu erfüllen.