定價總覽

飯店價格是指指定行程的雙人房最低價格，包含入住日期和住宿晚數。

總覽

您為飯店或行程組合定義的價格，是飯店搜尋結果的重點。請務必提供最新、準確且具競爭力的價格。

Google 顯示搜尋結果時，通常會使用價格快取的價格。每當您傳送包含價格更新的交易訊息給 Google 時，Google 會快取該項資料。

Google 也可即時要求您為飯店廣告帳戶提供最新價格資訊。當使用者搜尋特定飯店或行程組合時，Google 可以向您傳送「即時」要求或即時價格查詢訊息。如果您在指定時間範圍內回應，這個價格可能會顯示在使用者要求行程的結果中。Google 也會快取即時價格查詢的結果，以供日後的要求使用。

價格更新的大小

設定房間價格時，您必須提供提前預訂和入住天數 (LoS) 價值，並且分別列出這些值以及這些值和客房 ID 或費率方案 ID 的組合價格。預訂和 LoS 值的預設值如下：

  • 提前預訂最多 330 天
  • 最多 30 晚住宿

根據這些一般指南，單一客房的價格最多可以針對 9,900 個不同的項目 (330 * 30) 分別提供入住日期和晚數的組合。

以下矩陣說明單間飯店的部分行程資料。矩陣中的每個儲存格都代表一個行程入住日期和入住天數的組合；每個行程都代表 Google 針對房源要求的個別值：

哪些飯店和行程的重新價格

Google 提供的價格是取決於你的飯店清單。除非已停用，否則飯店清單動態饋給中的所有飯店都會以交易訊息價格重新設定，在某些情況下則採用即時價格查詢。

更新定價

更新價格的一般程序如下：

  1. 您可以在初始設定期間，定義飯店清單要價格的飯店，然後在清單變更時定期更新。

  2. 僅變更價格：Google 會傳送提示要求訊息給您的伺服器。

  3. 僅變更價格：您的伺服器會以提示回應訊息回應，定義應重新定價的飯店或行程組合。

  4. Google 會將查詢訊息傳送至您的伺服器。查詢訊息包含 Google 需要價格的飯店 ID 和行程。

  5. 如果是即時價格查詢，Google 會指定時間限制，讓飯店或行程顯示在目前競價中。

  6. 您的伺服器會傳回定義新價格的交易訊息。

  7. Google 會使用交易訊息中的定價資料來更新快取。

如要進一步瞭解「提取」和「價格變更」，請參閱傳遞模式。

交易訊息定價

如要設定飯店或行程的價格 (入住日期加上住宿天數)，請使用交易訊息，並在每趟行程中顯示一個 <Result>。

設定價格時，請遵守下列規範：

  • 費率：提供每個行程的最低雙人入住率。如果透過 Hotel Prices API 設定與網站中顯示的房價，使用者可能會感到困惑，並導致預訂失敗。

  • 住宿夜數：指定每趟行程的住宿總費用，以及「每晚」費率。Google 會為您計算每晚的房價。

  • 政策：設定費率時，請遵守 Google 的價格準確度政策。這表示 Google 搜尋結果中顯示的價格，不得與最終預訂價格明顯不同。

  • 全包式定價：如要讓美國和加拿大使用者顯示在產品資訊中，飯店通常必須從基本費率中拆分稅金與費用。詳情請參閱稅金與費用政策。

  • 四捨五入：請勿將價格、稅金和費用四捨五入。

如要進一步瞭解如何從商品目錄中移除飯店，請參閱「移除廣告空間」一文。

定價訊息

使用交易訊息重新設定行程的價格時，必須提供下列 <Result> 子元素：

  • <Property>
  • <Baserate>
  • <Tax>
  • <OtherFees>
  • <Checkin> (行程)
  • <Nights> (行程)

您可以在交易訊息中 optionally 包含下列 <Result> 的子元素：

  • <AllowablePointsOfSale>
  • <ChargeCurrency>
  • <Custom[1-5]>
  • <RoomBundle>
  • <RoomID>

如要進一步瞭解這些元素，請參閱 <Transaction>。

計費示例

以下範例將入住 1 至 7 晚的房型 (預設為雙人房)，入住日期為 6 月 7 日：

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">209.99</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">419.98</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">614.97</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>4</Nights>
    <Baserate currency="USD">819.96</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>5</Nights>
    <Baserate currency="USD">999.95</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>6</Nights>
    <Baserate currency="USD">1193.94</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>7</Nights>
    <Baserate currency="USD">1259.93</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
</Transaction>

每則交易訊息都可以包含任意數量的 <Result> 元素，只要訊息的總大小不超過 100 MB 即可。

價格更新頻率

因此，價格應隨價格變更而更新。操作方法取決於您選擇更新定價資訊的「提取」或「變更價格」方法。詳情請參閱選擇提供模式。

您可以設定 Google 傳送給您的頻率和即時價格查詢數量。詳情請參閱即時價格查詢一文。

全包式定價

視使用者的地理位置而定，您可以考慮使用全包式定價，而非逐項定價。

全包式定價包含客房基本房價的總值，加上交易訊息中 <Baserate> 元素的稅金及其他費用。Itemized 價格會將價格分成 <Baserate>、<Taxes> 和 <OtherFees> 元素。