Gdy Google wysyła żądanie podpowiedzi, Twoje serwery powinny przesłać odpowiedź z informacją o hotelach, których ceny zmieniły się od czasu, gdy ostatnio otrzymaliśmy z tych samych serwerów prawidłową odpowiedź na prośbę. Jeśli ceny się zmienią, Google przesyła <Query>
, który pobiera zaktualizowane dane o cenach w przypadku wskazanych hoteli i planów podróży.
Omówienie procesu ponownej wyceny znajdziesz na stronie z informacjami o cenach.
Aby zmienić cenę wybranych hoteli i ich planów podróży, wiadomości w odpowiedziach na podpowiedź korzystają z tych metod:
Główny element wiadomości z odpowiedzią to <Hint>
. Zamawiasz aktualizację hotelu lub planu podróży za pomocą co najmniej jednego elementu <Item>
. Pojedyncza wiadomość z odpowiedzią może definiować dowolną liczbę elementów <Item>
.
Każda wiadomość z odpowiedzią musi określać co najmniej 1 element <Property>
dla każdego elementu <Item>
. Identyfikator <Property>
identyfikuje hotel, korzystając z takich samych identyfikatorów jak Lista hoteli. Domyślnie w przypadku każdej blokady <Item>
podajesz jeden identyfikator hotelu. Możesz jednak polecić Google zezwolenie na wyświetlanie kilku hoteli w ramach jednej blokady, jeśli używasz zakresów dat zameldowania lub pobytu z określonym zakresem na potrzeby ponownej wyceny.
Dokładny proces żądania i odpowiedzi w przypadku planu podróży
Wiadomości z podpowiedziami mogą być oparte na poszczególnych planach podróży, np. z kombinacją daty zameldowania i długości pobytu. W takim przypadku podajesz datę i długość pobytu w swoich hotelach, a Google pobiera nowe ceny tylko dla tego planu podróży.
Odpowiedź partnera
Ten komunikat z odpowiedzią definiuje 1 usługę i 1 plan podróży:
<Hint>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2023-05-20</CheckInDate>
<LengthOfStay>3</LengthOfStay>
</Stay>
</Item>
</Hint>
Odpowiedź Google
W odpowiedzi na Twoją wiadomość z podpowiedzią Google wyświetla symbol <Query>
podobny do tego:
<Query>
<Checkin>2023-05-20</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
Utwórz: <Transaction>
Następnie musisz utworzyć <Transaction>
z aktualizacjami cen hotelu na ten pobyt:
5/20/23 - 5/23/23
Przepływ żądań i odpowiedzi dotyczących zakresów dat zameldowania
Wiadomość z odpowiedzią może zawierać zakres dat zameldowania zaczynający się od daty pierwszego zameldowania, a kończący się datą ostatniego zameldowania. Przy pobieraniu nowych danych o cenach pobieramy plany podróży związane z każdą datą zameldowania w hotelu, zaczynając od tych dat i rozpoczynając od wskazanego przez Ciebie okresu.
Zakresy dat partnera
Poniższy przykładowy komunikat z odpowiedzią definiuje pojedynczą właściwość z zakresem dat zameldowania:
<Hint>
<Item>
<Property>12345</Property>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</Item>
</Hint>
Odpowiedź Google
W odpowiedzi na tę wiadomość z podpowiedzią Google przesyła kod <Query>
podobny do tego:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<Nights>5</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
Utwórz: <Transaction>
Następnie musisz utworzyć <Transaction>
z aktualizacjami cen w przypadku tych pobytu w tym hotelu:
5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23
5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23
W tym przykładzie używana jest domyślna długość pobytu, czyli 5 nocy.
Przepływ żądań i odpowiedzi dotyczących zakresów pozostających
Wiadomość z odpowiedzią może zawierać zakres dat, które uległy zmianie. Informuje to Google, że powinien pobrać wszystkie plany podróży, których dotyczy którakolwiek z tych dat. Rzeczywisty zbiór pobranych planów podróży jest funkcją zbioru dat ze zmianami i maksymalnej długości pobytu.
Pobyt partnera w różnych zakresach czasowych
Ten przykładowy komunikat w odpowiedzi używa stałego zakresu:
<Hint>
<Item>
<Property>12345</Property>
<StaysIncludingRange>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</StaysIncludingRange>
</Item>
</Hint>
Odpowiedź Google
W odpowiedzi na Twoją wiadomość z podpowiedzią Google wyświetla symbol <Query>
podobny do tego:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>12345</Property>
<Property>67891</Property>
</PropertyList>
</Query>
Utwórz: <Transaction>
Następnie musisz utworzyć <Transaction>
z aktualizacjami cen hotelu, które są związane z tymi pobytami:
5/17/23 - 5/20/23
5/18/23 - 5/20/23
5/18/23 - 5/21/23
5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23
5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23