Wiadomości z odpowiedzią

Gdy Google wyśle wiadomość z żądaniem podpowiedzi, Twoje serwery powinny odpowiedzieć wiadomością z odpowiedzią na podpowiedź, która określa hotele, których ceny zmieniły się od ostatniego otrzymania przez Google odpowiedzi na podpowiedź z tych samych serwerów. Jeśli nastąpią jakiekolwiek zmiany cen, Google wyśle <Query>, aby pobrać zaktualizowane dane o cenach dla wskazanych hoteli i planów podróży.

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

Aby ponownie ustalić ceny wybranych hoteli i ich planów podróży, wiadomości z odpowiedzią na podpowiedź korzystają z tych metod:

Elementem głównym wiadomości z odpowiedzią na podpowiedź jest <Hint>. Prośba o zmianę hotelu lub planu podróży za pomocą co najmniej 1 elementu <Item>. Pojedynczy komunikat podpowiedzi może definiować dowolną liczbę elementów <Item>.

W każdym komunikacie z odpowiednią wskazówką musi być co najmniej 1 element <Property> dla każdego elementu <Item>. <Property> identyfikuje hotel za pomocą tych samych identyfikatorów co lista hoteli. Domyślnie dla każdego bloku <Item> musisz podać identyfikator hotelu. Możesz jednak poprosić Google o zezwolenie na wyświetlanie wielu hoteli w bloku, jeśli używasz zakresów dat zameldowania lub zakresów pobytu do zmiany cen.

Przebieg procesu przesyłania żądania i odpowiedzi dotyczącej dokładnego planu podróży

Wiadomości z podpowiedziami mogą być oparte na indywidualnych planach podróży, takich jak kombinacja daty zameldowania i długości pobytu. W tym 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

Ten komunikat odpowiedzi z podpowiedzią definiuje jedną usługę i jedną trasę:

<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 odpowiednią podpowiedzią <Query> w ten sposób:

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Utwórz: <Transaction>

Następnie utwórz <Transaction> z aktualizacjami cen hotelu na ten pobyt:

5/20/23 - 5/23/23

Proces przesyłania żądania i odpowiedzi dotyczącego zakresów dat zameldowania

Komunikat z wskazówką może określać zakres dat zameldowania, zaczynając od pierwszej daty zameldowania i kończąc na ostatniej dacie zameldowania. Gdy Google pobiera nowe dane o cenach, pobiera plany podróży dla każdej daty zameldowania w hotelu, począwszy od tych dat i rozszerzając je do wskazanego przez Ciebie czasu pobytu.

Daty w zakresie partnera

Ten przykład wiadomości z odpowiednią podpowiedzią definiuje jedną 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 odpowiednią podpowiedzią <Query>, która wygląda mniej więcej tak:

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

Proces żądania i odpowiedzi dotyczącego pobytu w ramach limitu

Odpowiedź na podpowiedź może zawierać zakres dat, które uległy zmianie. Informuje to Google, że należy pobrać każdy plan podróży, którego dotyczy którykolwiek z tych terminów. Rzeczywisty zestaw pobieranych planów podróży zależy od zestawu dat ze zmianami i maksymalnego czasu pobytu.

pobyty w zakresie partnera,

W tym przykładzie wiadomość z odpowiedzią zawiera zakresy pobytu:

<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 odpowiednią podpowiedzią <Query> w ten sposób:

<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 utwórz <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