Wiadomość o asortymencie

Przegląd

Wiadomość o zasobach reklamowych (OTA_HotelInvCountNotifRQ) określa liczbę zasobów reklamowych (liczbę pokoi fizycznych), które można zarezerwować w przypadku określonych typów pokoi. Wysyłając wiadomość dotyczącą asortymentu, podajesz, ile pokoi danego typu jest dostępnych w określonym dniu. Jeśli nie ma dostępnych pokoi tego typu, produkty związane z tym typem pokoju i datą nie będą się wyświetlać.

W sekcjach poniżej znajdziesz ogólne wytyczne, podstawowy przykład i scenariusze, które pomogą Ci zacząć dodawać i aktualizować asortyment oraz wysyłać wiadomości o asortymencie.

Przykłady różnych scenariuszy związanych z zasobami reklamowymi znajdziesz w sekcji Instrukcje.

Elementy wymagane i opcjonalne

W dokumentacji XML znajdziesz 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 o zasobach reklamowych korzystaj z przykładu składni zasobów reklamowych, aby mieć pewność, że używasz prawidłowego formatu.

Przed przesłaniem plików danych do Google możesz sprawdzić je za pomocą narzędzia XML innej firmy, np. xmllint. Informacje o schemacie wiadomości Inventory znajdziesz w artykule Schematy reklam hoteli.

Wytyczne

W przypadku wiadomości o asortymencie postępuj zgodnie z tymi wytycznymi:

  • Zasoby reklamowe są kluczowane według hotelu, daty i typu pokoju.

  • Aby wyświetlić cenę powiązaną z planem cenowym i liczbą osób, liczba dostępnych pokoi musi być większa niż 0 w przypadku wszystkich nocy pobytu.

  • Jeśli liczba pokoi jest równa 0, pokoje nie będą dostępne do rezerwacji dla określonego identyfikatora pokoju i zakresu dat.

  • Atrybut CountType musi zawsze mieć wartość 2, aby był prawidłowy, ponieważ wskazuje liczbę „dostępności potwierdzonej”.

  • Wysyłaj zaktualizowany asortyment za każdym razem, gdy w Twoim systemie nastąpi rezerwacja lub anulowanie pokoju.

Asortyment a dostępność

Zasoby to liczba pokoi, które można zarezerwować na podstawie liczby fizycznej, a dostępność wskazuje, czy można zarezerwować kombinację typu pokoju i planu cenowego. W przypadku ARI dostępność i zasoby reklamowe mogą się różnić w zależności od zestawu dat lub typu obiektu, a oba te elementy mają odpowiednie typy wiadomości. Asortyment i dostępność są powiązane z hotelem, datą i rodzajem pokoju, a w przypadku dostępności także z planem cenowym.

Może wystąpić „brak dostępności”, nawet jeśli są dostępne zasoby reklamowe, ponieważ zasoby reklamowe i dostępność są od siebie niezależne.

Dostępność ma 2 znaczenia. Po pierwsze, ogólna dostępność produktu w przypadku danego pobytu, na którą wpływają takie czynniki jak to, czy każda noc ma określoną cenę, asortyment powiązanego typu pokoju i czy ograniczenie dostępności jest otwarte. Po drugie, istnieje konkretne ograniczenie dotyczące produktu w danym dniu, reprezentowane przez <RestrictionStatus Restriction="Master" Status="Open"/> w OTA_HotelAvailNotifRQ, a zamknięcie tej dostępności jest znane jako „stop sell”.

Aby wyświetlić cenę produktu, asortyment musi być liczbą całkowitą większą niż 0 w przypadku pokoju, a ograniczenie dostępności musi być otwarte.

Przykład

Ta sekcja zawiera podstawowy przykład wiadomości o zasobach reklamowych z użyciem elementów wymaganych i opcjonalnych. Po przygotowaniu pliku musisz wysłać go do Google za pomocą wiadomości POST na ten punkt końcowy:

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

Więcej informacji o wysyłaniu wiadomości metodą push/POST znajdziesz w artykule Wysyłanie wiadomości.

W przypadku HotelCode użyj unikalnego identyfikatora hotelu, którego używasz w systemie do identyfikacji obiektu. Ta wartość musi być zgodna z identyfikatorem hotelu określonym za pomocą <id> w elemencie <listing> w pliku danych z listą hoteli. W przypadku <RoomID> użyj tego samego identyfikatora, którego używasz w systemie w przypadku typów pokoi. Spójność z systemem jest kluczowa, aby mieć pewność, że Google prawidłowo wyświetla Twoje dane.

Ten przykład pokazuje, jak skonfigurować zasoby reklamowe dla 13 pokoi, które można zarezerwować 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 znajdziesz scenariusz, który może wystąpić podczas wysyłania wiadomości o stanie asortymentu.

Scenariusz: jak zablokować możliwość rezerwowania sal

Opis

Musisz wskazać, że w określonym przedziale dat nie ma już dostępnych pokoi tego typu, które można zarezerwować. Najczęściej dzieje się tak, gdy wszystkie pokoje są wyprzedane.

Rozwiązanie

Ustawiasz wartość <InvCount Count> na 0 i dodajesz wybrany zakres dat.

Przykład

Ten przykład pokazuje, jak za pomocą parametru InvCount ustawić zasoby reklamowe na 0 w przypadku określonego pokoju i dat (np. pierwszych kilku tygodni 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>