Opis
Komunikat dotyczący zasobów reklamowych (OTA_HotelInvCountNotifRQ
) określa liczbę zasobów reklamowych (liczbę fizycznych sal), które można zarezerwować na potrzeby określonych typów sal. Wysyłając wiadomość o zasobach reklamowych, wskazujesz liczbę sal tego typu, które są dostępne w danym dniu. Jeśli nie ma dostępnych sal tego typu,
produkty powiązane z tym typem i datą nie będą wyświetlane.
Sekcje poniżej zawierają ogólne wskazówki, podstawowe przykłady i instrukcje, które pomogą Ci zacząć dodawać i aktualizować zasoby reklamowe oraz wysyłać komunikaty dotyczące zasobów reklamowych.
Przykłady różnych scenariuszy związanych z zasobami reklamowymi znajdziesz w instrukcji.
Elementy wymagane i opcjonalne
Dokumentacja XML zawiera opisy elementów wymaganych i opcjonalnych. Szczegółowe informacje o atrybutach i elementach podrzędnych znajdziesz w artykule Elementy i atrybuty zasobów reklamowych.
Składnia i schematy
Podczas tworzenia wiadomości dotyczącej zasobów reklamowych użyj przykładu składni zasobów reklamowych, aby mieć pewność, że używasz właściwego formatu.
Aby zweryfikować pliki danych z opublikowanymi schematami przed przesłaniem ich do Google, możesz użyć narzędzia XML innej firmy, np. xmllint. Schemat wiadomości dotyczących zasobów reklamowych znajdziesz w sekcji Schematy reklam hoteli.
Wytyczne
W przypadku wiadomości dotyczącej zasobów reklamowych postępuj zgodnie z tymi wskazówkami:
Informacje o zasobach reklamowych zależą od hotelu, daty i typu pokoju.
Aby wyświetlić cenę za powiązany plan taryfowy i obłożenie, liczba zasobów reklamowych musi być większa niż
0
w przypadku wszystkich nocy pobytu.Jeśli liczba zasobów reklamowych jest równa
0
, sale nie będą dostępne do rezerwacji w przypadku podanego identyfikatora i zakresu dat.Aby atrybut
CountType
był prawidłowy, musi zawsze mieć wartość2
, ponieważ wskazuje liczbę „nieokreślonej dostępności”.Wysyłaj zaktualizowane zasoby reklamowe za każdym razem, gdy w systemie wystąpi rezerwacja lub anulowanie rezerwacji.
Zasoby reklamowe a dostępność
Zasoby reklamowe to liczba sal do zarezerwowania ustalona na podstawie liczby pokoi, a dostępność wskazuje, czy dozwolone jest rezerwowanie kombinacji typu pokoju i planu taryfowego. W przypadku ARI dostępność i zasoby reklamowe mogą się różnić w zależności od daty lub typu zastosowania, a obie mają odpowiadające im typy wiadomości. Zasoby i dostępność zależą od hotelu, daty i typu pokoju. Dodajemy też plan cenowy dotyczący dostępności.
Wartość „brak dostępności” może wystąpić nawet wtedy, gdy dostępne są zasoby reklamowe, ponieważ zasoby i dostępność są od siebie niezależne.
Istnieją 2 koncepcje dostępności. Po pierwsze, mamy do czynienia z ogólną dostępnością produktu w przypadku danego pobytu, na którą wpływają takie czynniki, jak to, czy każda noc ma określoną stawkę, zasoby dotyczące powiązanego typu pokoju oraz obowiązują ograniczenia dostępności. Po drugie: mamy ograniczone ograniczenie dotyczące produktu w danym dniu oznaczone jako <RestrictionStatus
Restriction="Master" Status="Open"/>
w OTA_HotelAvailNotifRQ
, a zakończenie tej dostępności określa się mianem „przerwij sprzedaż”.
Asortyment musi być liczbą całkowitą większą niż 0
dotyczący sali, a ograniczenie dostępności musi być otwarte, aby cena produktu była widoczna.
Przykład
W tej sekcji znajdziesz podstawowy przykład komunikatu dotyczącego zasobów reklamowych, który zawiera elementy wymagane i opcjonalne. Po przygotowaniu pliku musisz wysłać go do Google za pomocą wiadomości POST do tego punktu końcowego:
https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif
Więcej informacji o przekazywaniu wiadomości w trybie push/OPUBLIKUJ znajdziesz w sekcji o wysyłaniu wiadomości.
W przypadku obiektu HotelCode
użyj unikalnego identyfikatora hotelu użytego w systemie do identyfikacji obiektu. Ta wartość musi być zgodna z identyfikatorem hotelu określonym za pomocą atrybutu <id>
w elemencie <listing>
w pliku danych Lista hoteli. W przypadku <RoomID>
użyj tego samego identyfikatora, który został użyty w systemie do określenia typów sal. Systematyczność z systemem jest niezbędna do prawidłowego wyświetlania danych przez Google.
Ten przykład pokazuje, jak skonfigurować zasoby reklamowe dla 13 sal do zarezerwowania w grudniu:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-02-25T20:50:37-05:00"
Version="3.0">
<POS><Source><RequestorID ID="partner_key" /></Source></POS>
<Inventories HotelCode="HotelID">
<Inventory>
<StatusApplicationControl Start="2022-12-01"
End="2022-12-31"
InvTypeCode="RoomID"/>
<InvCounts>
<InvCount Count="13" CountType="2"/>
</InvCounts>
</Inventory>
</Inventories>
</OTA_HotelInvCountNotifRQ>
Więcej przykładów znajdziesz w artykule Przykłady zasobów reklamowych.
Instrukcje
W tej sekcji opisano scenariusz, który może wystąpić podczas wysyłania wiadomości o asortymencie.
Scenariusz: jak zablokować rezerwację sal
Opis
Musisz wskazać, że nie ma żadnych innych sal, które można zarezerwować w określonym terminie, zwykle dlatego, że są wyprzedane.
Rozwiązanie
Ustawiasz dla parametru <InvCount Count>
wartość 0
i dodajesz odpowiedni zakres dat.
Przykład
Ten przykład pokazuje, jak za pomocą pola InvCount
ustawić 0
w zasobach reklamowych dla określonej sali i dat (np. w pierwszych tygodniach stycznia).
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-02-25T20:50:37-05:00"
Version="3.0">
<POS><Source><RequestorID ID="partner_key" /></Source></POS>
<Inventories HotelCode="Property_1">
<Inventory>
<StatusApplicationControl Start="2023-01-01"
End="2023-01-15"
InvTypeCode="ROOMID"/>
<InvCounts>
<InvCount Count="0" CountType="2"/>
</InvCounts>
</Inventory>
</Inventories>
</OTA_HotelInvCountNotifRQ>