Wiadomości z odpowiedzią

Gdy Google wysyła wiadomość z żądaniem podpowiedzi Hint Request, Twoje serwery powinny odpowiedzieć wiadomością z podpowiedzią, która określa hotele, których ceny zmieniły się od czasu, gdy Google otrzymało od tych samych serwerów prawidłową odpowiedź z podpowiedzią. Jeśli nastąpią jakiekolwiek zmiany cen, Google następnie wyśle <Query>, które pobierze zaktualizowane dane o cenach wskazanych hoteli i planów podróży.

Omówienie procesu zmiany cen znajdziesz w artykule Omówienie cen.

Wiadomości z podpowiedzią używają tych metod do zmiany cen wybranych hoteli i ich planów podróży:

Elementem głównym wiadomości z podpowiedzią jest <Hint>. Aby zaktualizować hotel lub plan podróży, użyj co najmniej 1 elementu <Item>. Pojedyncza wiadomość z podpowiedzią może zawierać dowolną liczbę elementów <Item>.

Każda wiadomość z podpowiedzią musi zawierać co najmniej 1 <Property> element dla każdego <Item>. Element <Property> identyfikuje hotel za pomocą tych samych identyfikatorów co lista hoteli. Domyślnie dla każdego bloku <Item> podajesz pojedynczy identyfikator hotelu. Jeśli jednak do zmiany cen używasz zakresów dat zameldowania lub pobytów w określonym zakresie, możesz poinstruować Google, aby zezwalało na używanie w bloku elementu wielu hoteli.

Przepływ żądania i odpowiedzi dotyczący dokładnego planu podróży

Wiadomości z podpowiedzią mogą być oparte na poszczególnych planach podróży, np. na połączeniu daty zameldowania i długości pobytu. W takim przypadku określasz datę zameldowania i długość pobytu w hotelach, a Google pobiera nowe dane o cenach tylko dla tego planu podróży.

Odpowiedź partnera

Ta wiadomość z podpowiedzią określa 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

Google odpowiada na Twoją wiadomość z podpowiedzią za pomocą <Query> podobnego 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 żądania i odpowiedzi dotyczący zakresów dat zameldowania

Wiadomość z podpowiedzią może określać zakres dat zameldowania, zaczynając od pierwszej daty zameldowania i kończąc na ostatniej. Gdy Google pobiera nowe dane o cenach, pobiera plany podróży dla każdej daty zameldowania w hotelu, zaczynając od tych dat i rozszerzając je do podanej przez Ciebie długości pobytu.

Zakresy dat partnera

Ten przykład wiadomości z podpowiedzią określa 1 usługę z zakresem dat zameldowania:

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

Odpowiedź Google

Google odpowiada na tę wiadomość z podpowiedzią za pomocą <Query> podobnego 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 hotelu na te pobyty:

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 długość pobytu wynosi 5 nocy. Domyślna długość pobytu to 30 dni.

Przepływ żądania i odpowiedzi dotyczący pobytów w określonym zakresie

Wiadomość z podpowiedzią może zawierać zakres dat, które uległy zmianie. Informuje to Google, że powinno pobrać wszystkie plany podróży, których dotyczą te daty. Rzeczywisty zestaw pobranych planów podróży jest funkcją zarówno zestawu dat ze zmianami, jak i maksymalnej długości pobytu.

Pobyty w określonym zakresie partnera

Ten przykład wiadomości z podpowiedzią używa pobytów w określonym zakresie:

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Odpowiedź Google

Google odpowiada na Twoją wiadomość z podpowiedzią za pomocą <Query> podobnego 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 na te pobyty:

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