Dokumentacja XML dotycząca dostępności, stawek i zasobów reklamowych (ARI)

Ten przewodnik po plikach XML zawiera szczegółowe informacje i przykłady kodu dotyczące różnych wiadomości, elementów i atrybutów dostępnych w plikach danych dotyczących dostępności, cen i zasobów (ARI).

ARI to tryb dostarczania cen, który kontroluje stawki za nocleg, dostępność i zasoby reklamowe oraz określa ograniczenia dotyczące sposobu, w jaki można je łączyć. Interfejs ARI zapewnia też elastyczność w zakresie uwzględniania podatków, opłat i promocji.

W przypadku niektórych głównych typów wiadomości służących do określania dostępności i zasobów reklamowych ARI korzysta ze standardowych protokołów OpenTravel Alliance (OTA).

Ceny zależne od długości pobytu

Ceny LOS-based umożliwiają określanie stawek według daty zameldowania i długości pobytu, a nie według daty pobytu. Jeśli określisz element <StatusApplicationControl> w przypadku cen opartych na długości pobytu, atrybuty @Start i @End oznaczają zakres dat zameldowania, dla których obowiązują stawki za długość pobytu.

Chociaż w przypadku cen opartych na długości pobytu nie ma już stawek za noc, wszystkie inne funkcje ARI (zasoby reklamowe, dostępność, reguły, promocje itp.) można nadal stosować do tych stawek i są one określane na poziomie nocy. Oznacza to, że jeśli Twoje systemy są bardziej zgodne z systemem cenowym opartym na długości pobytu, nadal możesz korzystać z bogatego zestawu funkcji ARI, a także z oszczędności przepustowości, które zapewnia korzystanie z nocnych aktualizacji dostępności i ograniczeń.

Ważna uwaga: każda usługa na Twoim koncie powinna korzystać ze stawek opartych na długości pobytu lub ze stawek za dzień.

Aby włączyć na koncie ceny oparte na długości pobytu, skontaktuj się z zespołem ds. technicznej obsługi klienta lub z nami.

Ważne: zanim udostępnimy ceny, musisz wysłać 4 typy wiadomości (transakcja, stawka, asortyment i dostępność). Zalecamy ograniczenie rozmiaru wiadomości ARI do 5 MB i przesyłanie maksymalnie 400 plików na sekundę.<OTA_HotelRateAmountNotifRQ> Unikaj wysyłania wielu nakładających się informacji o harmonogramie dotyczących konkretnych dat w 3-sekundowym odstępie od ostatniej wiadomości.

ARI używa tych wiadomości z żądaniem:

• Transaction (Dane usługi) Określa typ i pakiet informacji (abonament).

• OTA_HotelRateAmountNotifRQ Określa kwoty stawek za pokój na podstawie daty lub długości pobytu dla każdego produktu (kombinacji typu pokoju i abonamentu) w określonych zakresach dat.

• OTA_HotelAvailNotifRQ. Określa dostępność i ograniczenia na podstawie typu pokoju i planów cenowych. Za pomocą tego komunikatu można też aktualizować zasoby reklamowe, ale preferowany jest komunikat OTA_HotelInvCountNotifRQ.

• OTA_HotelInvCountNotifRQ Określa zasoby reklamowe w postaci fizycznych pokoi lub liczbę pokoi dostępnych na sprzedaż.

• TaxFeeInfo (opcjonalny). Określa podatki i opłaty dla poszczególnych usług. Ten komunikat nie jest wymagany, jeśli w komunikacie OTA_HotelRateAmountNotifRQ podano AmountAfterTax.

• Promotions (Opcjonalnie) Określa stawki promocyjne dla niektórych rezerwacji, pobytów i użytkowników.

• RateModifications (Opcjonalnie) Określa reguły modyfikacji stawek w przypadku określonych rezerwacji, pobytów i użytkowników.

• ExtraGuestCharges (Opcjonalnie) Określa, jak należy skonfigurować stawki dla dzieci i dodatkowych osób dorosłych.

Każda wiadomość zawiera podzbiór informacji, których Google używa do obliczania cen i dostępności wyświetlanych użytkownikom, gdy wyszukują Twoje obiekty z określonymi datami zameldowania i wymeldowania oraz liczbą osób.

Ważne: funkcje ARI są ograniczone do wiadomości i elementów opisanych w tym dokumencie referencyjnym XML dotyczącym zasobów reklamowych i cen (ARI) oraz w przewodniku po ARI. Żadne komunikaty, elementy ani atrybuty OTA, które nie zostały tu szczegółowo opisane, nie są obsługiwane w naszej implementacji ARI.

Ponadto inne elementy komunikatu transakcji, które nie są uwzględnione w tym pliku XML dotyczącym zasobów reklamowych i cen (ARI), nie są obsługiwane w przypadku korzystania z typu pliku danych ARI.

Google stale aktualizuje i ulepsza interfejs API. Jeśli w swoim systemie używasz dodatkowych funkcji związanych z cenami, poinformuj o tym Technology Account Manager(TAM), aby można było nadać im priorytet. W przeciwnym razie poinformujemy Cię, czy planujemy wprowadzenie tych funkcji.

Historia zmian w dokumentacji ARI XML

W tabeli poniżej znajdziesz tylko aktualizacje dokumentacji dotyczące zmian w funkcjach.

Data	Zmiany
14 sierpnia 2020 r.	Pierwsza wersja.
21 października 2020 r.	Dodano typ wiadomości Promocje.
17 listopada 2020 r.	W przypadku komunikatów transakcji (dane o obiekcie) zaktualizowaliśmy punkt końcowy i dodaliśmy atrybut action do elementów PropertyDataSet.
24 listopada 2020 r.	W przypadku komunikatów transakcji (danych usługi) dodaliśmy elementy <AllowablePackageIDs> i <AllowableRoomIDs>.
4 lutego 2021 r.	Dodano wiadomości z odpowiedzią.
25 lutego 2021 r.	Dodano: OTA_HotelInvCountNotifRQ.
21 października 2020 r.	Dodano typ wiadomości Rate Modifications (Modyfikacje stawek).