透過 XML 設定飯店清單

你可以透過下列任一方式設定飯店清單：

  • 提供 CSV 或 XML 檔案
  • 從 Hotel Center 上傳檔案
  • 代管伺服器上的檔案

本指南說明如何使用 XML 檔案設定飯店清單，並在伺服器上代管 XML 動態饋給，讓 Google 依照要求的時間下載 XML 檔案。如要瞭解設定飯店清單的其他方式，請參閱「如何設定飯店空房資料」一文。

XML 格式的飯店清單簡介

飯店清單檔案包含 Hotel Center 帳戶中所有房源的描述性資料，例如房源名稱、地址和地理編碼位置。

下方是 XML 檔案格式的飯店清單檔案基本範例。這個範例僅顯示檔案中指定的幾個 <listing> 元素。每個 <listing> 元素都代表一個屬性。

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address format="simple">
      <component name="addr1">6 Acacia Ave</component>
      <component name="addr2">Floor 5</component>
      <component name="city">London</component>
      <component name="province">Greater London</component>
      <component name="postal_code">SW1W 9TQ</component>
    </address>
    <country>GB</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

以 XML 建立飯店清單

如要以 XML 建立飯店清單動態饋給，請按照下列步驟操作：

  1. 參閱檔案相關規定。

  2. 按照飯店清單 XML 參考資料的說明編寫檔案。

  3. 使用飯店清單動態饋給結構定義驗證檔案。

驗證檔案後，請將動態饋給代管在你的伺服器上。或者，您也可以手動在 Hotel Center 中上傳清單。

在伺服器上代管 XML 動態饋給

使用飯店清單提取傳送方式，即可在自己的伺服器上代管飯店清單，Google 就會按照你偏好的頻率擷取動態饋給。建立飯店清單並驗證 XML 檔案後，請按照下列步驟操作：

  1. 按照代管規定的說明，準備 Google 檔案。

  2. 如要設定下列項目，請與客戶技術顧問 (TAM) 聯絡：

    • Google 的下載排程 (通常每週一次)
    • 下載網址和驗證規定

如果沒有發生任何錯誤，系統就會發布飯店清單，並在 Hotel Center 帳戶的「房源」分頁下方，顯示成功比對至 Google 地圖的所有房源。

如果發生錯誤，Google 會向您提供這些錯誤，方便您修正錯誤並重新準備檔案，以便再次下載。

代管規定

代管 XML 動態饋給時，請遵守下列規定：

伺服器需求

  • 伺服器必須可透過 HTTP 或 HTTPS 存取。

目錄規定

為確保 Google 會擷取完整的資料快照，且不會嘗試下載不完整的檔案，請在將檔案發布到 HTTP 伺服器時遵循下列規定：

  • 在 Google 擷取來源以外的目錄中開發並驗證動態饋給的 XML 檔案，即：請勿使用 download 目錄，

  • 成功驗證動態饋給的 XML 檔案後，請從下載目錄到新建的動態饋給，建立符號連結。

  • 如要提供 .zip 檔案，請在根目錄層級 (而非下載目錄中) 加入 XML 檔案。

檔案相關規定

  • 使用純文字檔案，而非類似 Microsoft Word 檔案的格式。

  • 請確認未壓縮的 XML 檔案不超過 100 MB。您可以將單一或多個 XML 檔案壓縮為單一 .zip 檔案。壓縮的 XML 檔案或 .zip 檔案沒有限制。

  • 檔案名稱如下所示：

    • 如果是單一 XML 檔案，請使用 PARTNER_NAME_local.xml。
    • 如果是 ZIP 檔案中的一或多個 XML 檔案，請使用 PARTNER_NAME_local.xml.zip

    ZIP 檔案中的個別 XML 檔案可以使用任何方式命名，不過我們建議您在每個檔案名稱加上語言代碼。

需要驗證

  • 您也可以選擇透過基本驗證或 DIGEST 驗證，使用使用者名稱和密碼來保護檔案。

  • 不支援 NTLM。