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 Hinweisantwort 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 zum Prozess der Preisänderung 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>. Sie können die Aktualisierung eines Hotels oder Reiseplans mit einem oder mehreren <Item>-Elementen anfordern. Eine Hinweisantwortnachricht kann beliebig viele <Item>-Elemente enthalten.

In jeder Hinweisantwortnachricht muss mindestens ein <Property>-Element für jedes <Item>-Element angegeben sein. Das Element <Property> identifiziert ein Hotel, indem es dieselben IDs wie in der 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 mit bestimmten Zeiträumen verwenden.

Anfrage- und Antwortablauf für genaue Reisepläne

Hinweisnachrichten können auf individuellen Reiseplänen basieren, z. B. auf der Kombination aus Anreisedatum 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 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 die Reisepläne für das Hotel für alle Check-in-Tage innerhalb dieses Zeitraums mit der von Ihnen angegebenen Aufenthaltsdauer ab.

Zeitraum des Partners

In der folgenden Beispiel-Hinweistantwortnachricht 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 einer <Query> 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 Nächte. Die Standardaufenthaltsdauer beträgt 30 Tage.

Anfrage- und Antwortablauf für Aufenthalte mit bestimmten Zeiträumen

In einer Hinweisantwortnachricht kann ein Zeitraum mit geänderten Datumsangaben angegeben sein. Dies weist Google darauf hin, alle Reisepläne abzurufen, die von diesen Datumsangaben betroffen sind. Die tatsächlich abgerufenen Reisepläne hängen von den Daten mit Änderungen und der maximalen Aufenthaltsdauer ab.

Aufenthaltsdauern des Partners

In der folgenden Beispiel-Hinweistantwortnachricht 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 und 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