Wiadomości z odpowiedzią

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