ARI-Übersicht

Verfügbarkeit, Preise und Bestand (ARI, Availability, Rates, and Inventory) ist ein Übermittlungsmodus für Preise, der Übernachtungspreise, Verfügbarkeit und Inventar steuert und Einschränkungen für deren Kombination bietet. ARI bietet auch die Flexibilität, Steuern, Gebühren und Angebote einzubeziehen.

Im Gegensatz zu den Liefermodi „Pull“ und „Geänderte Preise“ werden bei ARI-Feeds keine bestimmten Preise oder Reisepläne abgefragt. Stattdessen senden Sie Push-Nachrichten, wenn Ihr Preismodell neue oder geänderte Daten enthält, z. B. Änderungen an Preisdetails, Einschränkungen oder Verfügbarkeit.

Vorteile

ARI bietet folgende Vorteile:

  • Bandbreiteneffizienz: Erhöht die Bandbreiteneffizienz, indem das zu übertragende Datenvolumen reduziert wird. Durch das Senden von nächtlichen ARI-Daten und nur inkrementellen Änderungen kann Google Preise und Updates für eine breite Palette von Werten für Vorabkäufe und Aufenthaltsdauer berechnen.

  • Preisgenauigkeit: Verbessert die Preisgenauigkeit durch Verwendung eines Push-on-Change-Ereignismodells, das Liveaktualisierungen liefert.

  • Bessere Preisabdeckung: Durch die Verwendung detaillierter Daten, die in verschiedenen Reiseplänen kombiniert werden, wird eine höhere Preisabdeckung (Anzahl von Reiseplänen mit Preisen) erzielt.

  • Flexibilität: Ermöglicht größere Flexibilität durch das Anbieten von Angeboten und Paketen.

  • Nutzerfreundlichkeit: Die Daten werden so übertragen, wie sie in Ihrem System gespeichert sind. So müssen für viele Reisepläne keine Preise berechnet oder im Cache gespeichert werden.

Arten von Anfragenachrichten

ARI-Nachrichten, die an Google gesendet werden, werden als ARI-Anfragenachrichten bezeichnet. Google gibt daraufhin Antwortnachrichten zurück, die angeben, ob der Vorgang erfolgreich war oder fehlgeschlagen ist.

ARI folgt für einige der wichtigsten Nachrichtentypen den Standardprotokollen von OpenTravel Alliance (OTA), um Verfügbarkeit und Inventar zu definieren.

ARI verwendet die folgenden Anfragenachrichten:

  • Transaction (Unterkunftsdaten). Definiert den Zimmertyp und die Paketinformationen (Preisplan).

  • OTA_HotelRateAmountNotifRQ: Definiert die Preise pro Datum oder auf der Aufenthaltsdauer basierend auf der Belegung pro Produkt (Kombination aus Zimmertyp und Preisplan) für bestimmte Zeiträume.

  • OTA_HotelAvailNotifRQ. Definiert Verfügbarkeit und Einschränkungen basierend auf Zimmertyp und Preisplänen. Inventar kann auch über diese Nachricht aktualisiert werden. OTA_HotelInvCountNotifRQ wird jedoch bevorzugt.

  • OTA_HotelInvCountNotifRQ: Definiert das physische Zimmerinventar oder die Anzahl der Zimmer, die für den Verkauf verfügbar sind.

  • TaxFeeInfo (optional) Definiert Steuern und Gebühren pro Unterkunft. Diese Nachricht ist nicht erforderlich, wenn AmountAfterTax in der OTA_HotelRateAmountNotifRQ-Nachricht angegeben ist.

  • Promotions (optional): Definiert Aktionspreise für bestimmte Buchungen, Aufenthalte und Nutzer.

  • RateModifications (optional): Definiert Preisänderungsregeln für bestimmte Buchungen, Aufenthalte und Nutzer.

  • ExtraGuestCharges (optional): Definiert, wie Preise für Kinder und zusätzliche Erwachsene konfiguriert werden sollen.

Jede Nachricht enthält eine Teilmenge von Informationen, mit denen Google die Preise und Verfügbarkeit berechnet, die Nutzern angezeigt werden, wenn sie nach Ihren Unterkünften mit bestimmten Check-in- und Check-out-Daten sowie der gewünschten Belegung suchen.

Weitere Informationen zu ARI finden Sie in der XML-Referenz.

Push-Nachrichten

Zum Aktualisieren von ARI- und Unterkunftsinformationen senden Sie die zugehörigen Nachrichten, wenn sich Daten in Ihrem System ändern.

Beachten Sie beim Senden von Nachrichten die folgenden Richtlinien:

  • Mit dem Selfservice-Tool auf der Seite mit den Hotel Center-Preiseinstellungen können Sie Ihre IP-Adressen in unserem System hinzufügen oder aktualisieren.

  • Verwenden Sie den folgenden Basispfad für den Endpunkt:

    • https://www.google.com oder Host: www.google.com Port: 443

  • Senden Sie Nachrichten mit der Methode HTTP POST.

  • Setzen Sie den Content-Type-Header auf application/xml.

  • Auf Kontoebene gilt eine maximale Aktualisierungsrate von 400 Nachrichten pro Sekunde. Wenn Sie dieses Limit überschreiten, wird der Fehlercode 6032 zurückgegeben.

  • Verwenden Sie je nach den zu aktualisierenden Daten die folgenden Pfade:

    • Transaction (Unterkunftsdaten): /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ: /travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ: /travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo: /travel/hotels/uploads/taxes
    • Promotions: /travel/hotels/uploads/promotions
    • RateModifications: /travel/hotels/uploads/rate_modifications
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

Google antwortet auf jede empfangene Anfragenachricht mit einer HTTP 200 OK, wenn die Verbindung zum Server erfolgreich war, und fügt einen Text mit einer Antwortnachricht ein, die angibt, ob Updates erfolgreich angewendet wurden oder Warnungen oder Fehler aufgetreten sind. Wenn Sie als Antwort von Google einen HTTP-Fehlercode erhalten, senden Sie die Nachricht noch einmal. Wenn der HTTP-Antworttext Warnungen oder Fehler enthält, sollten diese behoben werden, bevor Sie die Nachricht noch einmal senden. Probleme bei bestimmten Nachrichten können Sie sich auch auf der Seite „Feedstatus“ im Hotel Center ansehen.

Live auf Google (LoG)

Mit Live auf Google (LoG) können Sie Ihre Hotels auf Google-Websites präsentieren. Da der Standardwert für die Aufenthaltsdauer eines Hotels true ist, werden alle neuen Hotels automatisch auf Google angezeigt.

Mit LoG können Sie Unterkünfte für Anzeigen und kostenlose Buchungslinks in Ihrem Hotel Center-Konto aktivieren und deaktivieren – unabhängig vom Status von Google Ads oder davon, ob für die Unterkunft Preise auf Google vorhanden sind. Dies gilt nur für Hotels und nicht für Ferienunterkünfte.

Es gibt zwei Möglichkeiten, den LoG-Wert eines Hotels festzulegen: Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

Weitere Informationen zu LoG finden Sie in der Hotel Center-Hilfe.

Travel Partner API, you can do the following: verwenden

  • Rufen Sie den Status Ihrer Unterkünfte über das Hotel Center auf oder verwenden Sie den Endpunkt hotelViews.list.

  • Rufen Sie eine Liste aller Ihrer Hotels ab, die auf Google angezeigt werden. Verwenden Sie dazu den Parameter filter mit liveOnGoogle = TRUE im Endpunkt hotelViews.list.

  • Mit hotelViews.summary können Sie eine Zusammenfassung der Properties für ein bestimmtes Konto abrufen, einschließlich der Anzahl der Properties, die auf Google online sind.

Weitere Informationen zum Festlegen von LoG mithilfe der API finden Sie im Artikel hotelViews.list und in der API-Referenz.