Nachricht „Transaktion (Unterkunftsdaten)“

Übersicht

Die Nachricht „ARI-Transaktion (Unterkunftsdaten)“ enthält Informationen zu den einzelnen Zimmertypen und -pakete (oder Preispläne) der Unterkunft. Die Daten jedes Zimmertyps umfassen eine eindeutige Kennung (RoomID), einen lokalisierten Namen, eine Beschreibung und URLs zum Zimmer Fotos. Jedes Paket enthält eine eindeutige Kennung (PackageID), die lokalisiert ist Name, Beschreibung, Belegung und Mehrwert.

Mit einer Transaktionsnachricht können Sie Folgendes tun:

• Definieren Sie Daten für eine oder mehrere Properties.
• Definieren Sie für jede Unterkunft den Zimmertyp und die Paketinformationen.
• Produktangebote kontrollieren

Außerdem können Sie Aktionen für Folgendes festlegen:

• Fügen Sie einer Unterkunft einen Zimmertyp und ein Paket hinzu.

  Wichtiger Hinweis :Der Zimmertyp ist auf 3.000 pro Unterkunft beschränkt. Pakete hat auch eine Limit von 3.000 pro Property. Mit einer <Transaction>-Nachricht können Sie Zimmertypen oder Pakete entfernen.

• Entfernen Sie einen Zimmertyp und ein Paket aus einer Unterkunft.

Beispiele für Transaktionsnachrichten finden Sie unter Transaktion (Unterkunftsdaten) Beispiele.

Erforderliche und optionale Elemente

Die XML-Referenz enthält Beschreibungen der erforderlichen und optionalen Elemente. Weitere Informationen zu Attribute und untergeordnete Elemente, siehe Elemente für Transaktionen (Unterkunftsdaten) und Attribute:

Syntax und Schemas

Verwenden Sie die Methode Transaktion (Unterkunftsdaten) Syntax Beispiel als Referenz verwenden, wenn Sie die Transaktionsnachricht erstellen, verwenden Sie das richtige Format.

Sie können ein XML-Tool eines Drittanbieters wie xmllint verwenden, um Ihre Feeds mit veröffentlichten Schemas vor der Übermittlung an Google zu prüfen. Das Schema für Transaktionsnachrichten finden Sie unter Hotelanzeigenschemas.

Richtlinien

Beachten Sie bei Transaktionsnachrichten die folgenden Richtlinien:

Maßnahmen:

delta: Zum Hinzufügen oder Aktualisieren neuer Zimmertypen und Pakete (Preispläne).

overlay: Wird verwendet, um alle Zimmertypen und Pakete für eine Unterkunft durch ein neuen Satz. Sie müssen Informationen zu allen Zimmertypen und Preisplänen enthalten, die Sie weiterhin verkaufen möchten.

Sprachunterstützung:

Geben Sie eine oder zwei Sprachen (Englisch und eine lokale Sprache für die Unterkunft) an. (falls erforderlich) in die Felder Name, Beschreibung und Bildunterschrift ein. Sie können weitere hinzufügen mehr als zwei Sprachen.

Zimmertypen und Pakete:

Wenn Sie einen Zimmertyp oder ein Paket aktualisieren, müssen Sie alle zugehörigen für diesen Zimmertyp oder dieses Paket. Wenn Sie beispielsweise ein müssen auch den Namen und die Beschreibung enthalten sein.

<AllowablePackageIDs> und <AllowableRoomIDs> sind optional. Wenn sie nicht festgelegt sind, kann jede Kombination aus Zimmertyp und Preisplan verwendet werden. Sie müssen weiterhin Verfügbarkeit und Preise mit den Zimmertyp- und Preisplan-IDs senden. Diese können Sie Produkte steuern und Kombinationen deaktivieren, nicht mehr unterstützt.

Senden Sie Google eine aktualisierte Transaktionsnachricht, wenn sich Zimmertypen oder Pakete ändern oder wichtige Details zu Zimmertypen oder Paketen hinzugefügt werden müssen.

Hinweis: Da Google Unterkunftsdaten speichert, die mit einer übereinstimmenden Property, Google kann diese Daten erst akzeptieren, nachdem die entsprechende Property erstellt wurde. "Übereinstimmung" im System. Wenn Sie alle Unterkünfte in Ihrem Listenfeed senden, spätere Fehler oder Verzögerungen zu vermeiden.

Beispiel

Dieser Abschnitt enthält ein einfaches Beispiel für eine ARI-Transaktionsnachricht mit erforderlich und optionale Elemente. Um Zimmertypen und Pakete hinzuzufügen oder zu aktualisieren, müssen Sie Verwenden Sie eine Aktion für delta, um Zimmertypen und Pakete hinzuzufügen oder zu aktualisieren, oder overlay zum Ersetzen aller Zimmertyp- und Paketdefinitionen (löscht Einträge).

Sie müssen für die Felder „Name“, „Beschreibung“ und „Untertitel“ eine bis zwei Sprachen angeben (Englisch und bei Bedarf eine lokale Sprache für die Unterkunft). Fügen Sie dann Informationen zu Immobiliendaten, einschließlich Links zu Fotos.

Verwenden Sie für <PropertyID> und <RoomID> dieselben IDs wie in Ihrem System. für Preispläne bzw. Zimmertypen. Die Einheitlichkeit mit deinem System Dies ist wichtig, um sicherzustellen, dass Ihre Preise und Daten auf Google korrekt angezeigt werden.

Hinweis :Google verwendet „ID“ für die Kennung für Zimmertyp und Paket (Preisplan); OTA-XML hingegen verwendet „code“. Sie müssen Ihre eigenen IDs verwenden, da Google diese nicht generiert. Für Unterkunftsdaten müssen Zimmertyp- und Preisplan-IDs eindeutig sein pro Property.

Nachdem Sie Ihre Datei vorbereitet haben, müssen Sie sie über eine POST-Nachricht an Google senden. an folgenden Endpunkt: https://www.google.com/travel/hotels/uploads/property_data

Weitere Informationen zum Pushen/POSTen von Nachrichten finden Sie unter Nachrichten pushen.

Das folgende Beispiel zeigt, wie die Transaktionsnachricht mit einem delta festgelegt wird. Aktion:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

Wenn Sie weitere Beispiele sehen möchten, z. B. für die Verwendung der Aktion overlay, fügen Sie einen Zimmertyp hinzu. und ein Paket mit vorhandenen Unterkunftsdaten erstellen sowie vorhandene Zimmertypen und Pakete, siehe Transaktion (Unterkunftsdaten) Beispiele.

Anleitungen

In diesem Abschnitt finden Sie Lösungen für Szenarien, die beim Senden von Transaktionsnachrichten auftreten können.

Szenario 1: Daten zu Zimmertypen entfernen

Wie entferne ich vorhandene Zimmertyp- und/oder Paketdaten?

Beschreibung

Sie haben mehrere Zimmertypen für die Unterkunft gesendet, darunter King- und Queen-Zimmer. Bei der Umgestaltung sind keine Zimmer mit Queensize-Bett verfügbar. Nur Zimmer mit Kingsize-Bett sind verfügbar. Zimmertypen sind derzeit verfügbar.

Lösung

• Sie müssen die nächtliche Verfügbarkeit, die Preise oder den Bestand für den Zimmertyp und die Paket-IDs, die entfernt oder deaktiviert wurden.
• Wenn der Zimmertyp oder das Paket entfernt oder deaktiviert wurde, senden Sie einen neuen Transaktionsnachricht mit action="overlay", die nur den Raum enthält Typen und Pakete, die noch aktiv sind und den entfernten Zimmertyp ausschließen oder Pakets.

Beispiel

In diesem XML-Snippet wird gezeigt, wie Sie mit der Aktion overlay einen Zimmertyp entfernen.

Hinweis: Dieses Beispiel bezieht sich zwar auf den Zimmertyp, Sie können aber auch denselben Zimmertyp verwenden. um die Paketdaten zu entfernen.

Hier ist die ursprüngliche delta-Aktion, die die Zimmertypen „King“ und „Queen“ umfasst:

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

Legen Sie dann overlay fest, um den Zimmertyp „Queen“ zu entfernen und den King zu behalten. Zimmertyp:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

Szenario 2: Produkte mit „AllowablePackageIDs“ steuern

Wie steuere ich Produkte (Kombinationen von Zimmertypen und Paketen), wenn Pakete nach Zimmertyp gruppiert sind?

Hinweis :Wenn Ihre Zimmertypen nach Paketen gruppiert sind, siehe Szenario 3.

Beschreibung

Einige Ihrer Pakete sind nur für bestimmte Zimmertypen verfügbar. Für Wenn Ihre Unterkunft vier Zimmertypen hat (einschließlich der Präsidentensuite), und sechs verschiedene Pakete, aber nur wenige Angebote sind für das Präsidentensuite, können Sie die Berechtigung angeben.

Lösung

Eine aktualisierte Transaktionsnachricht senden, in der angegeben ist, welche Produkte enthalten sind im Paket mit <AllowablePackageIDs>.

Hinweis: Verwenden Sie entweder <AllowablePackageIDs> oder <AllowableRoomIDs>, aber nicht und welches Element Sie verwenden, hängt davon ab, ob Ihr System die Hierarchie Zimmer>Paket oder Paket>Raum. Ist keines dieser Elemente im Transaktionsnachricht, Zimmertypen können mit jedem Paket kombiniert werden.

Beispiel

Dieses XML-Snippet zeigt, wie <AllowablePackageIDs> zur Angabe von Paketen verwendet wird Zimmertyp verwendet. Hier ist der Zimmertyp „Penthouse-Suite“ Penthouse-All-inclusive-Paket oder kostenloses Frühstückspaket Bei der Zimmerart „King Suite“ ist nur das King All-inclusive-Paket oder Haustierfreundliches Paket.

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

Hinweis: Wenn Sie zum Deaktivieren <AllowablePackageIDs> oder <AllowableRoomIDs> verwenden eine Kombination, die Sie möglicherweise früher verwendet haben, die jetzt aber in Ihren müssen Sie ARI nicht für alle Daten erneut senden, nur um den vorherigen Daten.

Szenario 3: Produkte mit „AllowableRoomIDs“ steuern

Wie kann ich Produkte (Kombinationen von Zimmertypen und Paketen) steuern, wenn Zimmertypen nach Paket gruppiert sind?

Hinweis :Wenn Ihre Pakete nach Zimmertyp gruppiert sind, finden Sie weitere Informationen unter Szenario 2.

Beschreibung

Eine Kombination aus Zimmertyp und Paket wird nicht mehr als Produkt verkauft oder Sie möchten was in einem neuen Paket enthalten ist. Sie möchten z. B. angeben, Zimmer mit Kingsize- und Queensize-Bett mit Meerblick und Paket.

Lösung

Senden Sie eine aktualisierte Transaktionsnachricht, in der die genauen im Paket enthaltenen Produkte mithilfe des Elements <AllowableRoomIDs> angegeben sind.

Beispiel

Dieses XML-Snippet zeigt, wie <AllowableRoomID> zur Angabe von „Meerview King“ verwendet wird und „Queen“.

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>