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. Ta są używane zarówno w przypadku cen pull, jak i zmienionych trybami wyświetlania.

Elementem głównym wiadomości w zapytaniu jest <Query>.

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

Cena: Google wysyła wiadomość w zapytaniu z prośbą o aktualizację cen w wybranych hotelach.
Metadane: Google wysyła wiadomość dotyczącą zapytania, która zawiera prośbę o dostęp do danych o pokoju. i informacje o pakiecie 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 komunikat w zapytaniu jako żądanie HTTP POST z Content-Type nagłówek ustawiony na „application/xml” a nagłówek User-Agent ustawiony na Google-HotelAdsPrices Wyjątkiem od tej reguły jest ręczne testowanie integrację punktu końcowego ceny za pomocą Google-TravelAds-Live. Te próbki Zapytania mogą nie zawierać nagłówka User-Agent.

Szczegółowe formatowanie wiadomości dotyczących zapytań można znaleźć w Zapytanie XML Reference.

Komunikaty z zapytaniem o ceny

Komunikaty o zapytaniach dotyczących cen określają miejsca zakwaterowania lub kombinacje obiektów lub planu podróży, dla których to Ty 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 szczególne typy wiadomości dotyczących zapytań:

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. Stosowanie się do tych zaleceń może zwiększyć skuteczność Twoje 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 aktualne ceny to żądania od Google dotyczące aktualizacji cen w czasie rzeczywistym w w odpowiedzi na wyszukiwania użytkowników. Google otrzymuje od użytkownika żądanie wyszukiwania dla hotel i plan podróży, a także dlatego, że dane o cenach są niedostępne lub nie są dostępne. Google prosi Cię o aktualizację ceny w momencie wyszukiwania. Na Google próbuje uzyskać cenę i wyświetlić ją w w momencie wyszukiwania.

Wszystkie żądania zapytań o ceny w czasie rzeczywistym mają limit czasu odpowiedzi, który zwykle wynosi do 4000 milisekund. 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 z odpowiedzią pozostanie otwarte przez 10 minut lub określone 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. Zapytania o aktualne ceny pozwalają mogą wyświetlić bardziej aktualne ceny, odpowiadające tym, czego szukał klient.

Zapytania o aktualne ceny mają stanowić dodatkowy mechanizm ustalania cen aktualizacje. Głównym mechanizmem ponownej wyceny jest nadal pobieranie lub zmiana cen. 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.

Reguły korzystania z zapytań o rzeczywistą cenę

W przypadku tego planu podróży dane nie są przechowywane w pamięci podręcznej, ponieważ żądany plan podróży nie istnieje jest nietypowe, np. daty przypadają w bardzo odległej przyszłości lub hotel jest bardzo które są rzadko wyszukiwane.
Żądana data nie jest domyślna.

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

Google zwykle zapisuje w pamięci podręcznej wyniki aktywnej ceny, aby zapewnić na temat planu podróży nie są już wysyłane żadne zapytania. Może zażądać zarówno jednego hotelu, jak i jednego planu podróży. oraz kombinacji hoteli i pojedynczych planów podróży.

Funkcja aktualizowania cen na podstawie kontekstu pozwala Google wysyłać określone Żądania rzeczywistej ceny na podstawie typu urządzenia użytkownika, kraju, z którego pochodzi oraz liczby osób, 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.

Za pomocą zapytań kontekstowych

Zapytania kontekstowe to zwykłe żądania aktualizacji naszej bazy danych na potrzeby określonych kombinacji właściwości lub planu podróży. Zawierają listę użytkowników, kontekstów, które są popularne w przypadku tych kombinacji. Jeśli Użyto stawek warunkowych, a następnie może być kosztowny na wszystkich możliwych kontekstach, dlatego użyj tej listy kontekstów użytkownika, aby ograniczyć swoją odpowiedź. Zwracane ceny tylko dla określony kontekst użytkownika obejmuje większość trafnych zapytań.

Wiadomości z zapytaniem o metadane

Wiadomości z zapytaniem o metadane zawierają szczegółowe informacje o pokoju i pakiecie dla określonych właściwości.

Gdy otrzymasz wiadomość z zapytaniem o metadane, w odpowiedzi na tego e-maila wpisz: komunikat <Transaction> określający ceny żądanych usług 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 cen wiadomości dotyczących zapytań oraz metadanych Zapytanie. Dodatkowe przykłady można znaleźć w Zapytanie XML Reference.

Przykładowy plan podróży

Ten przykład przedstawia cenę <Query>, która prosi o aktualizację cen 4 hotele, dostępne na 3 noce w okresie 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 każdego hotelu:

5/23/18 - 6/26/18

Przykład zapytania o rzeczywistą cenę

Przykład poniżej pokazuje zapytanie o rzeczywistą cenę z limitem czasu odpowiedzi. z 500 milisekund:

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

Ten przykład wymaga podania ceny za 1 hotel:

6/23/23 - 6/25/23

Przykładowa odpowiedź na to zapytanie dotycząca wiadomości transakcji znajduje się w Ceny Plik XML dotyczący zasobów reklamowych sal (transakcje).

Przykład zapytania kontekstowego

Poniżej znajduje się przykład z zapytaniem o kontekst:

<?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 mogą też określać urządzenie 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 podpowiedzi.

Ten przykład przedstawia wiadomość z ceną <Query> dotyczącą daty zameldowania zakresy:

<?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 w przypadku następujących pobytu (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 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/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ść w zapytaniu odpowiadasz komunikatem o transakcji, określa metadane dotyczące pokoju i pakietu. Więcej informacji: Definiowanie metadanych pomieszczenia i pakietu