定價總覽

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

總覽

您為飯店或行程組合定義的價格，是飯店搜尋結果的核心。請務必確保價格資訊正確且具競爭力。

一般來說，Google 會在顯示搜尋結果時，使用價格快取中的價格。每當您傳送內含價格更新的交易訊息給 Google 時，Google 就會快取該資料。

Google 也能即時向你索取 Hotel Ads 帳戶的最新價格。當使用者搜尋特定飯店或行程組合時，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> 元素。