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 podpowiedziami 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 podpowiedziami 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 dla hotelu na następujący 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 długości pobytu, którą wskażesz.

Zakres 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 następujące 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 użyto długości pobytu wynoszącej 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 dla hotelu na następujące 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

Pobyty w określonym zakresie: limity grupowania i dzielenie zapytań

Google ogranicza każde zapytanie pobierające do maksymalnie 10 tys. kombinacji pary hotel – plan podróży (hotel, data zameldowania i długość pobytu). W przypadku podpowiedzi dotyczącej pobytu w określonym zakresie liczba kombinacji jest obliczana za pomocą wzoru na pole trapezu, aby obliczyć liczbę kombinacji pary hotel – plan podróży w przypadku zapytań dotyczących pobytu w określonym zakresie:

$$ \text{Total Items} = \left( \text{Date Span} \times \text{LOS} + \frac{\text{LOS} \times (\text{LOS} + 1)}{2} \right) \times N_{\text{hotel_batch_size}} $$

Gdzie:

  • Date Span: łączna liczba dni między <FirstDate> a <LastDate> (Date span = LastDate – FirstDate + 1).
  • LOS: maksymalna długość pobytu żądana w podpowiedzi (np. <AffectedNights>14</AffectedNights>).
  • \(N_{\text{hotel_batch_size}}\): liczba usług uwzględnionych w pakiecie zapytań (skonfigurowana za pomocą hotel_batch_size).

Co się stanie,gdy podpowiedź przekroczy 10 tys. elementów?

Jeśli obliczona liczba elementów przekroczy 10 tys., Google automatycznie podzieli obciążenie zapytania:

  1. Pierwsza próba (pobyt w określonym zakresie): mniejsze okno dat obejmujące początek zakresu jest wysyłane za pomocą <AffectedNights>.
  2. Pierwsze rozwiązanie awaryjne (jeśli jest obsługiwane – zakres dat zameldowania): spróbujemy wysłać mniejsze pozostałe części zakresu dat jako zapytania dotyczące zakresu dat zameldowania za pomocą <Nights> (zapytanie poniżej).
  3. Ostatnie rozwiązanie awaryjne (Dokładne plany podróży): wrócimy do rozszerzenia zestawu zapytań do poszczególnych dokładnych planów podróży.
<!-- Example: Remainder batch dispatched after a split -->
<Query>
  <FirstDate>2026-10-01</FirstDate>
  <LastDate>2026-10-31</LastDate>
  <Nights>14</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>
  • Zachowaj równowagę rozmiarów pakietów usług: jeśli aktualizujesz duże okna dat (np. od 180 do 365 dni) z długością pobytu wynoszącą co najmniej 14 nocy, poproś swojego technicznego opiekuna klienta w Google o ustawienie wartości hotel_batch_size na niższą, aby zapobiec dzieleniu podpowiedzi.
  • Zawężaj zakres podpowiedzi: gdy informujesz Google o zmianach cen, ogranicz zakresy <FirstDate> i <LastDate> do konkretnych przedziałów dat, w których faktycznie zmieniły się stawki, zamiast wysyłać cały rok kalendarzowy.
  • Jeśli Twoje podpowiedzi obejmują duże zakresy dat: upewnij się, że Twój parser akceptuje zarówno , jak i w blokach zawierających <FirstDate> i <LastDate>, aby można było używać wielu typów zapytań dotyczących zakresu do obsługi żądań pobierania.