本頁面由 Cloud Translation API 翻譯而成。

查詢訊息

查詢訊息是 Google 提出的價格或中繼資料更新要求。他們「提取」和「價格變更」兩者搭配使用放送模式。

Query 訊息的根元素為 <Query>。

Query 訊息的結構取決於訊息類型：

定價：Google 會傳送查詢訊息，要求更新價格指定飯店
中繼資料：Google 會傳送查詢訊息，要求取得會議室相關資料指定飯店和套裝行程資訊

由您定義 Google 用於查詢訊息和即時資料的端點在初始設定期間查詢定價。如需更多資訊請與客戶技術顧問 (TAM) 聯絡。

Google 會以 HTTP POST 要求的形式傳送查詢訊息，並加上 Content-Type 標頭已設為「application/xml」User-Agent 標頭則設為 Google-HotelAdsPrices。這項規則在手動測試期間透過 Google-TravelAds-Live 整合價格端點這些範例查詢不一定包含 User-Agent 標頭。

如需查詢訊息的詳細格式，請參閱查詢 XML 參考資料。

定價查詢訊息

定價查詢訊息可指定其資源或行程組合設定價格

伺服器收到定價查詢訊息時，應傳回含有 <Transaction> 訊息，內含要求的價格資訊。

詳情請參閱定價總覽。

查詢訊息有三種特殊類型：

即時價格：啟用後，系統會在使用者積極使用時傳送查詢瀏覽指定房源或行程組合的價格並指定回應時間
啟用情境：啟用這個選項後，系統就會納入使用者情境建議。 Google 傳送的每一個查詢，而這些建議最能反映搜尋指定房源或行程的常見使用者類型組合。遵循這些建議可能有助於提高回應。
中繼資料：這項要求可提供活動的會議室和套裝方案詳細資訊。指定屬性。

即時價格查詢

即時價格查詢是 Google 針對以下項目提出的即時價格更新要求：回應使用者搜尋。Google 收到使用者搜尋要求飯店或行程組合，且無法取得定價資料，Google 會在你搜尋時要求你提供最新價格資訊。取代為即時價格查詢，Google 會嘗試取得價格並顯示在結果。

所有即時價格查詢要求都有回應時間限制，高達 4000 毫秒這項限制是在即時價格查詢中指定請求。如未在時限內提供回覆，錯失了特定商機的參與機會但建議你仍要提供價格，以便快取並用於日後商機。回應連線會保持開啟 10 分鐘，可以在合作夥伴設定中明確指定

即時價格查詢也能根據當下的情境進行查詢，並擷取以下參數：使用者國家/地區、裝置類型、可住人數 (房客人數)，以及訪客是成人或兒童使用即時價格查詢時根據顧客搜尋內容顯示最新價格。

即時價格查詢是另一種計價機制更新。重新定價的主要機制仍為「提取」或「變更」。即時價格查詢可填補 Google 缺少的缺口飯店或行程組合的價格。

即時價格查詢使用規則

由於要求的行程沒有特定行程的快取資料非尋常性，例如日期非常遠，或是飯店較少人搜尋
要求的日期非預設日期。

注意：預設日期不適用於即時價格查詢。即時影像只有非預設日期才要求價格查詢。

Google 通常會快取即時價格的結果，確保相同的飯店或系統未再次查詢行程。可以同時要求單項飯店或行程以及多飯店或單一行程的組合。

搭配情境的即時價格功能可讓 Google 傳送根據使用者的裝置類型 (所在的國家/地區) 的即時價格請求以及包含兒童在內的人數兩者查詢訊息和交易訊息都會展開以包含 <Context> 元素，用來定義查詢參數。價格來源包含內容的即時價格查詢可快取為 Room Bundle。是否為特定入住人數的價格，並以條件式費率的形式呈現供國家/地區或使用者裝置使用

使用情境查詢

使用內容查詢是定期要求更新資料庫特定屬性或行程組合。其中包含使用者清單顯示這些組合的熱門內容。如果系統會使用「條件式費率」，然後針對所有可能的使用者情境傳送費率可能所費不貲，因此利用這個使用者情境清單來限制您的回應。僅退貨時的價格指定的使用者情境涵蓋大多數的相關使用者查詢。

中繼資料查詢訊息

中繼資料查詢訊息包含會議室和套件資訊的詳細資料屬性。

收到中繼資料查詢訊息時，您應該以用於指定所要求房源價格的 <Transaction> 訊息 <Result> 元素中。

詳情請參閱「定義會議室和套件中繼資料」。

控制查詢

本節說明如何控制哪些屬性和行程可以是 Google 查詢訊息的主旨。

行程界線

您要使用 <ItineraryCapabilities>。您可以定義規則以及入住天數上限

您可以設定 <MaxAdvancePurchase> 和 <MaxLengthOfStay> 的預設值適用於所有飯店或行程組合。您也可以製定飯店群組的設定

查詢訊息範例

本節提供幾個有關定價查詢訊息和中繼資料的範例查詢訊息。如需更多範例，請參閱查詢 XML 參考資料。

行程範例

以下範例顯示要求更新價格的定價 <Query> 入住 4 間飯店的空房為 3 晚，自 2023 年 5 月 23 日起：

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

以下範例要求每間飯店的房價更新：

5/23/18 - 6/26/18

即時價格查詢範例

以下範例顯示設有回應時間限制的即時價格查詢每 500 毫秒：

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

以下範例要求單一飯店的價格：

6/23/23 - 6/25/23

如需此查詢的交易訊息回應範例，請前往定價與Room Inventory (交易) XML 參考資料。

使用情境查詢範例

以下範例為含有情境查詢的範例：

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

使用情境查詢時，只能指定使用者所在國家/地區結構定義。日後查詢也可能指定使用者的裝置和可住人數。

入住日期範圍

如果採用「價格變更」功能，查詢訊息的結構將取決於並顯示入住日期範圍的提示類型、完全比對行程或範圍限定行程。如要進一步瞭解提示類型，請參閱提示回應訊息。

以下範例顯示入住日期的價格 <Query> 訊息範圍：

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

本例要求在下列入住天數更新價格 (每筆飯店)：

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

範圍住宿

以下範例顯示範圍限定範圍的定價 <Query> 訊息入住：

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

以下範例要求每間飯店的房價更新：

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

此外，在指定夜間「之前」(但包含) 開始的入住天數：

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

中繼資料查詢訊息

以下範例顯示要求中繼資料的 <Query> 訊息變數和套件資訊的更新：

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

您以下列類型的「查詢」訊息回應：定義 Room 和套件中繼資料。若需更多資訊，請參閲定義房間和套件中繼資料，