Wiadomości z odpowiedzią

Gdy Google wyśle wiadomość z prośbą o wskazówkę, Twoje serwery powinny odpowiedzieć wiadomością z odpowiedzią na prośbę o wskazówkę, która określa hotele, których ceny zmieniły się od ostatniego razu, gdy Google otrzymało z tych samych serwerów odpowiedź na prośbę o wskazówkę. Jeśli nastąpią zmiany cen, Google wyśle <Query>, które pobierze zaktualizowane dane o cenach wskazanych hoteli i tras.

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

Wiadomości z odpowiedzią na podpowiedź korzystają z tych metod, aby ponownie wycenić wybrane hotele i plany podróży:

Elementem głównym wiadomości z odpowiedzią jest <Hint>. Prośbę o zaktualizowanie hotelu lub planu podróży możesz przesłać za pomocą co najmniej 1 elementu <Item>. Pojedynczy komunikat Hint Response może definiować dowolną liczbę elementów <Item>.

Każda wiadomość Hint Response musi zawierać co najmniej 1 element <Property> dla każdego elementu <Item>. <Property> identyfikuje hotel za pomocą tych samych identyfikatorów co lista hoteli. Domyślnie w przypadku każdego bloku <Item>określasz jeden identyfikator hotelu. Jeśli jednak używasz zakresów dat zameldowania lub zakresów pobytu do zmiany cen, możesz poinstruować Google, aby zezwalał na wiele hoteli w bloku elementów.

Dokładny przebieg żądania i odpowiedzi dotyczących planu podróży

Wskazówki mogą być oparte na poszczególnych planach podróży, np. na kombinacji 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ą właściwość i jedną trasę:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Odpowiedź Google

Google odpowie na Twoją wiadomość Hint Response, wysyłając <Query> podobną do tej:

<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 w przypadku następnego pobytu:

5/20/23 - 5/23/23

Przepływ żądania i odpowiedzi dotyczący zakresów dat zameldowania

Wiadomość z odpowiedzią na podpowiedź może określać zakres dat zameldowania, od pierwszej do 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 sięgając do długości pobytu, którą wskażesz.

Zakres dat 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

Google odpowiada na tę wiadomość z odpowiedzią za pomocą <Query> podobnej do tej:

<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 dla tych pobytów w danym 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 długości pobytu wynoszącej 5 nocy. Domyślna długość pobytu to 30 dni.

Proces przesyłania żądania i uzyskiwania odpowiedzi w przypadku pobytów w określonym przedziale czasu

Wiadomość Hint Response może zawierać zakres dat, które uległy zmianie. Dzięki temu Google będzie wiedzieć, że ma pobrać każdy plan podróży, którego dotyczą te daty. Rzeczywisty zestaw pobranych planów podróży zależy zarówno od zestawu dat ze zmianami, jak i od maksymalnej długości pobytu.

Pobyty w określonym przedziale czasu u partnera

Poniższy przykład wiadomości z odpowiedzią wykorzystuje pobyty 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 odpowie na Twoją wiadomość Hint Response, wysyłając <Query> podobną do tej:

<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 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