Hinweisantwortnachrichten

Wenn Google eine Hinweisanfragenachricht sendet, sollten Ihre Server mit einer Hinweisantwortnachricht antworten. Darin sind die Hotels angegeben, deren Preise sich geändert haben, seit Google das letzte Mal eine erfolgreiche Hinweisantwort von denselben Servern erhalten hat. Bei Preisänderungen sendet Google eine <Query>, die die aktualisierten Preisdaten für die angegebenen Hotels und Reisepläne abruft.

Eine Übersicht zur Preisneuberechnung finden Sie in der Preisübersicht.

In Hinweisantwortnachrichten werden die folgenden Methoden verwendet, um die Preise der ausgewählten Hotels und ihrer Reisepläne zu aktualisieren:

Das Stammelement einer Hinweisantwortnachricht ist <Hint>. Mithilfe von <Item>-Elementen fordern Sie an, dass ein Hotel oder ein Reiseplan aktualisiert wird. Eine Hinweisantwortnachricht kann beliebig viele <Item>-Elemente enthalten.

In jeder Hinweisantwortnachricht muss mindestens ein <Property>-Element pro <Item> angegeben werden. Der <Property> identifiziert ein Hotel anhand derselben IDs wie in der Hotelliste. 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 Check-in-Zeiträume oder Aufenthalte in bestimmten Zeiträumen für die Preisneuberechnung verwenden.

Anfrage- und Antwortablauf für genaue Reisepläne

Hinweisnachrichten können auf einzelnen Reiseplänen basieren, z. B. auf einer 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 dann nur die neuen Preisdaten für diesen Reiseplan ab.

Antwort des Partners

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

<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>, die der folgenden ähnelt:

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

<Transaction> erstellen

Es wird dann erwartet, dass Sie eine <Transaction> mit Preisaktualisierungen für das Hotel für den folgenden Aufenthalt erstellen:

5/20/23 - 5/23/23

Anfrage- und Antwortablauf 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. Wenn Google neue Preisdaten abruft, ruft Google Reisepläne für jedes Check-in-Datum des Hotels ab, beginnend mit diesem Datum und bis zur von Ihnen angegebenen Aufenthaltsdauer.

Zeitraum des Partners

Im folgenden Beispiel für eine Hinweisantwortnachricht wird eine einzelne Unterkunft mit einem Check-in-Zeitraum definiert:

<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>, das in etwa so aussieht:

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

<Transaction> erstellen

Es wird dann erwartet, dass Sie eine <Transaction> mit Preisaktualisierungen für die folgenden Aufenthalte in diesem Hotel 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 wird die Standardaufenthaltsdauer von 5 Nächten verwendet.

Anfrage- und Antwortablauf bei Aufenthalten in bestimmten Zeiträumen

Eine Hinweisantwortnachricht kann einen Datumsbereich enthalten, der sich geändert hat. Dies weist Google darauf hin, alle Reisepläne abzurufen, die von einem dieser Termine betroffen sind. Die tatsächlich abgerufenen Reisepläne hängen sowohl vom Satz von Daten mit Änderungen als auch von der maximalen Aufenthaltsdauer ab.

Aufenthalte in bestimmten Zeiträumen des Partners

In der folgenden Hinweisantwortnachricht werden Aufenthalte in bestimmten Zeiträumen verwendet:

<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>, die der folgenden ähnelt:

<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

Es wird dann erwartet, 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