Wiadomości z odpowiedzią

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