Ta strona została przetłumaczona przez Cloud Translation API.

Zapytania dotyczące zapytań

Wiadomości z zapytaniami to żądania od Google dotyczące aktualizacji cen lub metadanych. Są one używane w przypadku obu trybów dostarczania: pobierania z podpowiedziami i zmiany cen.

Elementem głównym wiadomości z zapytaniami jest <Query>.

Struktura wiadomości z zapytaniem zależy od typu wiadomości:

Ceny: Google wysyła wiadomość z zapytaniem o aktualizację cen w wybranych hotelach.
Metadane: Google wysyła wiadomość z zapytaniem o dane o pokoju i informacje o pakietach w wybranych hotelach.

Określasz punkt końcowy, z którego Google będzie korzystać na potrzeby komunikatów zapytań i transmisji na żywo Zapytania o ceny podczas początkowej konfiguracji. Aby dowiedzieć się więcej, skontaktuj się z technicznym menedżerem konta (TAM).

Google wysyła wiadomość z zapytaniem jako żądanie HTTP POST z nagłówkiem Content-Type ustawionym na „application/xml” i nagłówkiem User-Agent ustawionym na Google-HotelAdsPrices. Wyjątkiem od tej reguły jest ręczne testowanie integracji punktu końcowego cen za pomocą Google-TravelAds-Live. Te przykładowe zapytania mogą zawierać nagłówek User-Agent lub nie.

Szczegółowe informacje o formatowaniu wiadomości z zapytaniami znajdziesz w pliku referencyjnym XML zapytań.

wiadomości z zapytaniem o ceny,

Wiadomości z zapytaniem o ceny określają kombinacje obiektu i planu podróży, dla których podajesz ceny.

Gdy serwer otrzyma wiadomość dotyczącą zapytania z informacjami o cenach, powinien w odpowiedzi przesłać kod Komunikat <Transaction> zawierający żądane informacje o cenie.

Więcej informacji znajdziesz na stronie z cennikiem.

Istnieją 3 specjalne typy wiadomości zapytania:

Aktywna cena: jeśli ta opcja jest włączona, zapytania są wysyłane, gdy użytkownik aktywnie korzysta z usługi. przeglądanie cen dla określonej kombinacji miejsca zakwaterowania lub planu podróży, w określonym terminie.
Z kontekstem: jeśli ta opcja jest włączona, w każdego zapytania wysyłanego przez Google, a rekomendacje odzwierciedlają typowe rodzaje użytkowników, którzy szukają danego miejsca zakwaterowania lub planu podróży; kombinacji. Postępowanie zgodnie z tymi zaleceniami może zwiększyć skuteczność Twoich odpowiedzi.
Metadata (Metadane): to prośba o szczegółowe informacje o pokojach i pakietach przeznaczonych do określonych właściwości.

Zapytania o aktualne ceny

Zapytania o ceny na żywo to żądania Google dotyczące aktualizacji cen w czasie rzeczywistym w odpowiedzi na wyszukiwania użytkowników. Google otrzymuje od użytkownika żądanie wyszukiwania obejmujące hotel lub plan podróży. Ponieważ dane o cenach są niedostępne lub nieaktualne, Google prosi o ich zaktualizowanie w momencie wyszukiwania. W przypadku zapytań o ceny na żywo Google próbuje uzyskać cenę i wyświetlić ją w wynikach w momencie wyszukiwania.

Wszystkie żądania zapytań o rzeczywistą cenę mają limit czasu odpowiedzi, który wynosi zwykle do 4000 ms. Ten limit jest określony w zapytaniu o rzeczywistą cenę użytkownika. Jeśli nie uda się udzielić odpowiedzi w wyznaczonym terminie, spowoduje to że nie weźmie udziału w konkretnej ofercie. Zalecamy jednak podając cenę, aby można było zapisać ją w pamięci podręcznej i używać na potrzeby przyszłych ofert. Połączenie służące do wysłania odpowiedzi pozostaje otwarte przez 10 minut lub przez czas określony w konfiguracji partnera.

Zapytania o aktualne ceny również mają kontekst kontekstowy i pozwalają uzyskać informacje o cenach: następujące parametry: kraj użytkownika, typ urządzenia, liczba osób (liczba gości), oraz czy są to dorośli czy dzieci. Dzięki zapytaniom o rzeczywistą cenę możesz wyświetlać bardziej aktualne ceny, które pasują do tego, czego szuka klient.

Zapytania o bieżące ceny mają stanowić dodatkowy mechanizm ustalania cen aktualizacje. Głównym mechanizmem ponownego ustalania cen jest nadal metoda „Pull” lub „Changed pricing”. Zapytania o aktualne ceny pomagają wypełnić luki, które nie są dostępne dla Google cen w przypadku kombinacji hoteli i planów podróży.

Zasady korzystania z zapytań o ceny na żywo

Dane w pamięci podręcznej dla danego planu podróży nie istnieją, ponieważ ten plan jest nietypowy, np. daty są bardzo odległe w czasie lub hotel jest bardzo rzadko wyszukiwany.
Żądana data nie jest domyślna.

: Uwaga: daty domyślne nie są dostępne w przypadku zapytań o aktualną cenę. Żądania rzeczywistej ceny są przesyłane tylko w przypadku dat innych niż domyślne.

Google zwykle przechowuje w pamięci podręcznej wyniki wyszukiwania cen w czasie rzeczywistym, aby nie wysyłać ponownie zapytania o ten sam hotel lub ten sam plan podróży. Może ono obejmować zarówno pojedyncze hotele, jak i kombinacje hoteli oraz pojedyncze lub wielokrotne plany podróży.

Funkcja Cen w czasie rzeczywistym z kontekstem umożliwia Google wysyłanie konkretnych zapytań o ceny w czasie rzeczywistym na podstawie typu urządzenia użytkownika, kraju, w którym prowadzi wyszukiwanie, oraz liczby pasażerów, w tym dzieci. Zarówno Zapytanie i wiadomość transakcji są rozwinięte Element <Context>, który definiuje parametry zapytania. Ceny otrzymane od Bieżące zapytania o ceny wraz z kontekstem mogą być przechowywane w pamięci podręcznej jako pakiet pokoi, jeśli jest to cena za konkretne miejsce oraz stawka warunkowa, w przypadku kraju lub urządzenia użytkownika.

Zapytania z kontekstem

Zapytania kontekstowe to zwykłe prośby o zaktualizowanie naszej bazy danych w przypadku określonej usługi lub kombinacji planów podróży. Zawierają one listę kontekstów użytkowników, które są popularne w przypadku tych kombinacji. Jeśli używasz stawek warunkowych, wysyłanie stawek dla wszystkich możliwych kontekstów użytkownika może być kosztowne. Możesz więc użyć tej listy kontekstów użytkownika, aby ograniczyć odpowiedź. Zwracane ceny tylko dla określony kontekst użytkownika obejmuje większość trafnych zapytań.

Jeśli chcesz otrzymywać zapytania z kontekstem, skontaktuj się ze swoim opiekunem klienta ds. technicznych (TAM). Może on potwierdzić, że chcesz otrzymywać takie komunikatów, a następnie dostosuj konfigurację, aby zacząć wysyłać konteksty użytkowników w swoich zapytaniach.

Wiadomości z zapytaniami o metadane

Wiadomości z zapytaniem o metadane zawierają szczegółowe informacje o pokojach i pakietach w określonych obiektach.

Gdy otrzymasz wiadomość z zapytaniem o metadane, odpowiedz wiadomością <Transaction>, która określa ceny żądanych obiektów w elementach <Result>.

Więcej informacji znajdziesz w artykule o definiowaniu metadanych pomieszczenia i pakietu.

Zapytania kontrolne

Z tej sekcji dowiesz się, jak kontrolować, które miejsca zakwaterowania i plany podróży może być tematem wiadomości z zapytaniem od Google.

Granice planu podróży

Granice zapytań o ceny określa się za pomocą funkcji <ItineraryCapabilities> Określasz reguły określające zakres dat i maksymalnej długości pobytu.

Możesz ustawić wartości domyślne dla parametrów <MaxAdvancePurchase> i <MaxLengthOfStay> które dotyczą wszystkich kombinacji hoteli i planów podróży. Możesz też zdefiniować te ustawienia grup hoteli.

Przykładowe zapytania

Ta sekcja zawiera kilka przykładów wiadomości z zapytaniem o ceny i wiadomości z zapytaniem o metadane. Dodatkowe przykłady można znaleźć w pliku referencyjnym zapytania XML.

Przykładowy plan podróży

Ten przykład pokazuje dane cenowe <Query>, które wymagają aktualizacji cen dla 4 hoteli, dostępne na 3 noce, począwszy od 23 maja 2023 r.:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

W tym przykładzie żądamy aktualizacji cen w każdym hotelu:

5/23/18 - 6/26/18

Przykład zapytania o rzeczywistą cenę

Poniższy przykład pokazuje zapytanie o rzeczywistą cenę z ograniczeniem czasu odpowiedzi do 500 ms:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

W tym przykładzie żądamy ceny za jeden hotel:

6/23/23 - 6/25/23

Przykładową odpowiedź na to zapytanie znajdziesz w pliku XML dotyczącym cen i asortymentu pokoi (transakcje).

Przykład zapytania z kontekstem

Ten przykład pokazuje zapytanie z kontekstem:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

Zapytania dotyczące kontekstu określają tylko kontekst kraju użytkownika. W przyszłości takie zapytania mogą też określać urządzenie użytkownika i liczbę osób.

Zakresy dat zameldowania

Jeśli korzystasz ze zmiany cen, struktura wiadomości z zapytaniem zależy z typem podpowiedzi stosowanej dla zakresów dat zameldowania, lub plany podróży zróżnicowane. Aby uzyskać więcej informacji na temat każdej z tych opcji, typy podpowiedzi znajdziesz w sekcji Wiadomości z odpowiedziami na wskazówki.

Ten przykład pokazuje komunikat <Query> dotyczący cen w przypadku zakresów dat zameldowania:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

W tym przykładzie żądamy aktualizacji cen za następujące pobyty (dla każdego hotelu):

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

Noclegownie

Przykład poniżej pokazuje komunikat z ceną <Query> dla zakresu pobyty:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

W tym przykładzie żądamy aktualizacji cen w każdym hotelu:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

Pobyty Plus, które rozpoczęły się przed (ale obejmują) daną noc:

5/20/23 - 5/23/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

Wiadomość z zapytaniem o metadane

Poniższy przykład pokazuje wiadomość <Query> wymagającą metadanych Aktualizacje informacji o salach i pakietach w kilku usługach:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

Na tego typu wiadomość zapytania należy odpowiedzieć wiadomością transakcyjną, która definiuje metadane pokoju i pakietu. Więcej informacji znajdziesz w artykule Definiowanie metadanych sal i pakietów.