Gdy Google wysyła wiadomość z prośbą o podpowiedź, Twoje serwery powinny w odpowiedzi wysłać wiadomość z odpowiedzią na podpowiedź wskazującą hotele, których ceny zmieniły się od czasu ostatniego otrzymania przez Google pomyślnej odpowiedzi z podpowiedzią z tych samych serwerów. Jeśli ceny się zmienią, Google wysyła element <Query>
, który pobiera zaktualizowane dane o cenach dla wskazanych hoteli i planów podróży.
Omówienie procesu ponownej wyceny znajdziesz w Cenniku.
W odpowiedziach na podpowiedź używa tych metod do zmiany cen wybranych hoteli i ich planów podróży:
Elementem głównym wiadomości z odpowiedzią na podpowiedź jest <Hint>
. Możesz poprosić o zaktualizowanie hotelu lub planu podróży za pomocą co najmniej 1 elementu <Item>
. Pojedyncza odpowiedź na podpowiedź może zdefiniować dowolną liczbę elementów <Item>
.
Każda wiadomość z odpowiedzią na podpowiedź musi określać co najmniej 1 element <Property>
w przypadku każdego elementu <Item>
. <Property>
identyfikuje hotel, używając tych samych identyfikatorów co lista hoteli. Domyślnie dla każdej bloku <Item>
podajesz 1 identyfikator hotelu. Możesz jednak polecić Google zezwolenie na wyświetlanie wielu hoteli w ramach blokady produktów, jeśli do ponownej wyceny używasz zakresów dat zameldowania lub pobytów w przedziale czasu.
Dokładny przepływ prośby o plan podróży i odpowiedzi
Sugestie mogą opierać się na poszczególnych planach podróży, takich jak połączenie daty zameldowania się i długości pobytu. W tym przypadku podajesz datę zameldowania i długość pobytu, a Google pobierze nowe dane o cenach tylko dla tego planu podróży.
Odpowiedź partnera
Ten komunikat z odpowiedzią na wskazówkę definiuje jedną właściwość i pojedynczy 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 odpowiedzią na podpowiedź zamieszczamy atrybut <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ć obiekt <Transaction>
z aktualizacjami cen tego 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 – począwszy od daty pierwszego zameldowania, a kończąc na datę ostatniego zameldowania. Gdy Google pobiera nowe dane o cenach, Google pobiera plany podróży dla każdej daty zameldowania się w hotelu, zaczynając od tych dat i przekraczając wskazaną przez Ciebie długość pobytu.
Daty ustawione przez partnera
Ten przykład wiadomości z odpowiedzią na podpowiedź definiuje jedną 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 odpowiedzią na podpowiedź zamieszczamy atrybut <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ć obiekt <Transaction>
z aktualizacjami cen dla tych pobytów 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żyto domyślnej długości pobytu wynoszącego 5 nocy.
Przepływ żądań i odpowiedzi na zmiany zakresu
Wiadomość z odpowiedzią może zawierać zakres dat, które uległy zmianie. Informuje to Google, że powinno pobrać wszystkie plany podróży, na które wpływa którakolwiek z tych dat. Rzeczywisty zestaw pobranych planów podróży to funkcja zestawu dat ze zmianami oraz maksymalnej długości pobytu.
Pobyty partnera z zakresu zakresu
Następująca przykładowa wiadomość z odpowiedzią na podpowiedź korzysta z pobytu w zakresach:
<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 odpowiedzią na podpowiedź zamieszczamy atrybut <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ć obiekt <Transaction>
z aktualizacjami cen hotelu w przypadku tych pobytów:
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