透過 XML 設定飯店清單

如要設定飯店清單,請使用下列其中一種方法:

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

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

關於 XML 格式的飯店清單

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

下圖是 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 檔案可以採用任何方式命名,但我們建議您在每個檔案名稱加上語言代碼。

驗證需求

  • 您可以視需要使用 BASIC 或 DIGEST 驗證,透過使用者名稱和密碼保護檔案。

  • 不支援 NTLM。