飯店清單 XML 參考資料

飯店清單是一或多個 XML 檔案，會列出您要為其建立的所有飯店 提供定價資訊飯店清單檔案本身不含價格資訊 可能不準確或不適當

飯店清單的根元素是 <listings> 元素，其中包含 描述屬性的 <listing> 元素。

在初始導入過程中建立飯店清單。 並在定期維護作業中新增或移除飯店

確認您的檔案符合語法規範。 舉例來說，使用 UTF-8 編碼，並新增 XML 標記中的 encoding 屬性。

建立飯店清單後，您可以使用飯店業者手動上傳至 Google 置中或交由您的 伺服器。

找出並修正資料問題

如要找出並修正飯店清單的資料問題，請參閱下列文章：

產品資訊規定

如要放送 Google 飯店廣告，飯店清單中的房源必須 具備下列條件：

  • 提供付費房客可入住的房間
  • 具有對外開放的實體據點和固定地點
  • 固定牆壁和管線
  • 最短入住天數不超過 7 天

不符合資格的房源常見示例包括郵輪和 因為這類公寓通常不符合 Listing requirements 條件。

露營小木屋和其他設有固定牆壁、水管工程 以及氣候控制 (包括木製爐具或丙烷暖氣)。 不符合資格的戶外住宿設施包括：

  • 可供房客入住的露營區
  • 露營車營地，可供房客自攜露營車

<listings>

<listings> 是飯店清單的根元素，其中包含 <language> 元素和至少一個 <listing>。

<listings> 元素會顯示在飯店清單的以下位置 XML 階層：

+ <listings>
    + <language>
    + <datum>
    + <listing>

語法

<listings> 元素使用下列語法：

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
    xsi:noNamespaceSchemaLocation="schema_xsd">
  <language> language_code</language>
  <datum> datum_code </datum>
  <listing> listing</listing>
  ...
</listings>

屬性

<listings> 元素的屬性如下：

屬性 必填與否 說明
xmlns:xsi 必填 請設為 http://www.w3.org/2001/XMLSchema-instance。
xsi:noNamespaceSchemaLocation 必填 請設為 http://www.gstatic.com/localfeed/local_feed.xsd。

子元素

<listings> 元素包含下列子元素：

子項元素 必填與否 類型 說明
<language> Required string 撰寫動態饋給時使用的語言。設定這項屬性的值 元素加進 雙字母語言代碼。例如 en 代表英文。
<datum> Optional enum 這個元素可指定 動態饋給中提供的經緯度座標。如果沒有基準值 提供後，此元素的預設值是 WGS84， 多數新款的 GPS 裝置都會用到。而東京的狀況僅適用於 我們僅適用於英國和日本地區的客戶

這個元素的有效值如下：

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
，瞭解如何調查及移除這項存取權。 注意：如要使用 WGS84 的預設值，請不要加入 飯店清單的 <datum> 元素。
<listing> Required <listing> 動態饋給中每間飯店的一或多個項目。請注意， 清單中的每間飯店都必須有網站專屬的 ID，且 絕不可重複使用這個 ID

範例

結構化地址

以下範例是含有結構化標記的部分飯店清單 地址：

<?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 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>6 Elm Ave Unit 3, Boston, MA, 02472</address>
    <country>US</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>

選擇性內容

以下範例是部分飯店清單，其中列出 包含選用的 <content>：

<?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>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<listing>

飯店清單 <listings> 元素中的飯店定義。

<listing> 元素會顯示在飯店清單的以下位置 動態饋給 XML 階層：

+ <listings>
    + <language>
    + <listing>

語法

<listing> 元素使用下列語法：

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <!-- Specify <listing>'s child elements in the order shown below. -->
    <id>hotel_ID</id>
    <name>hotel_name</name>
    <address>
      <component name="addr1">street_address_1</component>
      <component name="addr2">street_address_2</component>
      <component name="city">city_name</component>
      <component name="province">province_name</component>
      <component name="postal_code">postal_code</component>
    </address>
    <!-- You can also define an address freeform, although this is not recommended: -->
    <!-- <address>freeform_address</address> -->

    <country>country_code</country>
    <latitude>hotel_latitude</latitude>
    <longitude>hotel_longitude</longitude>
    <phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>content</content>
  </listing>
</listings>

屬性

<listing> 元素沒有屬性。

子元素

<listing> 元素包含下列子元素：

子項元素 必填與否 類型 說明
<id> Required string 飯店的專屬 ID。

注意：這個值在網站上不得重複。正確做法 不要重複使用 ID，否則可能會在嘗試 解決房源比對問題。
<name> Required string 飯店的名稱，例如： 
<name>Belgrave House</name>
<address> Required Object or string

飯店的完整實際位置，

這個元素會使用 format 這個單一屬性，也就是 必須設為 simple。

您至少必須提供街道地址、城市、州/省或區域。 和飯店的郵遞區號使用 <component> 位兒童 元素來描述地址的每一個部分：

  • addr1：飯店的主要街道地址，
  • addr2：次要街道地址 (如有需要)。
  • addr3：街道地址的第三部分 (如果有的話) 無從得知
  • city：飯店所在城市的名稱。
  • province：飯店的所在州/省、地區或 省。
  • postal_code：飯店的郵遞區號。

例如：

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

或者，您可以提供「任意形式」雖然這是 不建議。例如：

<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>

請注意，訂單方塊或其他僅供郵寄的地址 視為完整的實際地址
<country> Required string 這則商家資訊的所在國家/地區。值必須是 雙字母國家/地區代碼。 例如美國是「US」加拿大則是「CA」。例如： 
<country>US</country>
<latitude> Required* float 與商家資訊中列出的所在位置對應的緯度，適用對象 範例： 
<latitude>37.423738</latitude>

您可以使用 GeoCoding 工具產生這個值，例如 Google Maps API。
<longitude> Required* float 與商家資訊中列出的所在位置對應的經度，適用對象 範例： 
<longitude>-122.090101</longitude>

您可以使用 GeoCoding 工具產生這個值，例如 Google Maps API。
<location_precision> Optional integer 屬性經緯度經過模糊處理時，房源位置的精確度 (以公尺為單位)。0 (0) 表示不會模糊處理，表示為確切位置。注意： 這個元素僅適用於度假民宿。
<phone> Required* string

飯店的一或多個聯絡電話號碼。如果商家資訊為商家 分行，請提供分行地點的電話號碼 而非中央總部的電話號碼。

type 屬性可以是下列任一項：

  • fax：傳真電話號碼。
  • main：主要語音電話號碼。
  • mobile：手機號碼。
  • tdd：失聰的電信裝置 (TDD) 電話號碼
  • tollfree：免付費電話號碼。

例如：

<!-- Singapore (country code +65) -->
<phone type="main">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</phone>

您至少應提供 main 類型。
<category> Optional string 房源的類型，例如飯店。合作夥伴可以使用任何內部 用來描述房源的類別，例如「商務旅館」 「resorts」「汽車旅館」和類似的情況。
<content> Optional <content> 商家資訊所使用的詳細資料，例如說明、評分、 各項資源的特徵和功能

* 必須輸入電話號碼「或」經緯度。三 建議您同時定義兩者

範例

結構化地址

以下範例是含有結構化標記的部分飯店清單 地址：

<?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 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>6 Elm Ave Unit 3, Boston, MA, 02472</address>
    <country>US</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>

選擇性內容

以下範例是部分飯店清單，其中列出 包含選用的 <content>：

<?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>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<content>

新增商家資訊，例如評分、評論、設施或 。<content> 為選用元素。<content>內， 所有子元素皆為選用

<content> 元素會顯示在飯店清單的以下位置 動態饋給 XML 階層：

+ <listings>
    + <language>
    + <listing>
        + <content>

語法

<content> 元素使用下列語法：

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      <!-- Specify <text>'s child elements in the order shown below. -->
      <text type="description">
        <link>listing_link</link>
        <title>listing_title</title>
        <author>listing_author</author>
        <body>listing_description</body>
        <date month="MM" day="DD" year="YYYY"/>
      </text>
      <!-- 0 or more reviews: -->
      <review type="[editorial|user]">
        ...
      </review>
      <!-- 0 or more attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="custom_0">custom_attribute_0</client_attr>
        <client_attr name="custom_1">custom_attribute_1</client_attr>
        <client_attr name="custom_2">custom_attribute_2</client_attr>
        <client_attr name="custom_3">custom_attribute_3</client_attr>
        <client_attr name="custom_4">custom_attribute_4</client_attr>
        <client_attr name="hotel_brand">hotel_brand</client_attr>
        <client_attr name="num_reviews">number_of_reviews</client_attr>
        <client_attr name="rating">aggregate_rating</client_attr>
      </attributes>
      <!-- a picture of the hotel or property-->
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main Hotel Picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

屬性

<content> 元素沒有屬性。

子元素

<content> 元素包含下列子元素：

子項元素 必填與否 類型 說明
<text type="description"> Optional Object

供應商提供的商家資訊所連結的網頁。 具有下列子元素：

  • <link>：說明的連結。加入 「http://」或
    「https://」加入這個元素中 (選用)。
  • <title>：說明的標題 (選用)。
  • <author>：說明的作者 (選用)。
  • <body>：說明的內文 (必要)。
  • <date>：說明的日期 (選填)。

    • 注意：這些元素必須按上述順序顯示。
<review type="[editorial|user]"> Optional <review>

包含商店資訊的使用者評論或編輯評論。您的 您可以在商家資訊中擁有不限數量的評論，不論何種類型。

你不必納入自有房源的所有評論 <listing> 元素；您必須將此元素 並選出描述此商家資訊特色的評論 品質
<attributes> Optional Object

包含 0 或多個 <client_attr> 子元素， 提供房源的詳細資料。子元素會使用下列項目 語法：

<client_attr name="attribute_name">attribute_value<client_attr>

如需子元素的清單和說明，請參閱 <attributes>。

所有 <client_attr> 元素皆為選用元素。

如果有 <website> 子元素，就必須 放置在任何 <client_attr> 元素前方
<image> Optional Object 重複標記，包含詳細的圖片資訊。

範例

以下範例是部分飯店清單，其中包含 <content> 元素：

<?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>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<review>

包含使用者評論或編輯評論。您不必全部加入 <listing> 元素中產品資訊的評論；這個元素是用於 提供可充分瞭解此商家資訊特色的精選評論 或品質

<review> 元素會顯示在飯店清單的以下位置 動態饋給 XML 階層：

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

語法

<review> 元素使用下列語法：

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      ...
      <!-- Specify <review>'s child elements in the order shown below. -->
      <review type="editorial">
        <link>review_link</link>
        <title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
        <author>review_author</author>
        <rating>review_rating</rating>
        <body>review_text</body>
        <date>review_date</date>
        <servicedate>review_servicedate</servicedate>
      </review>
      <review type="user">
        <link>review_link</link>
        <author>review_author</author>
        <date month="MM" day="DD" year="YYYY"/>  <!-- Date is for reviews of type "user" only -->
        <servicedate month="MM" day="DD" year="YYYY"/>  <!-- Service Date is for reviews of type "user" only -->
        <rating>review_rating</rating>
        <body>review_text</body>
      </review>
    </content>
  </listing>
</listings>

屬性

<review> 元素的屬性如下：

屬性 必填與否 說明
type Required 評論類型。設為下列其中一個值：
  • editorial：網站或其他評論的評論 授權。
  • user：使用者的評論。

子元素

<review> 元素包含下列子元素：

子項元素 必填與否 類型 說明
<link> Optional string 評論的連結。加入「http://」或「https://」在此流程的各個階段 元素。
<title> Optional string (僅限編輯評論) 評論的標題。
<author> Optional string 評論的作者；例如「Susan von Trapp」您也可以 顯示評論的網站或出版品的名稱 。
<rating> Optional string 介於 0 到 10 (含) 之間的浮點數，代表 獲得的評分。例如「8.9」。
<body> Optional string 評論的內容。這個元素不應包含 HTML。
<date month="MM" day="DD" year="YYYY"/> Optional Object (僅限使用者評論) 評論的日期，請使用 以下為該元素的屬性：
  • day：每個月的哪一天；例如 「7」。
  • month：當月，其中 1 = 1 月 ... 12 = 12 月。
  • year：四位數的年份。例如：2023"

例如，2023 年 6 月 7 日的寫法為：

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (僅限使用者評論) 評論者造訪評論內容的日期。格式與 <date> 相同。

例如，2023 年 6 月 7 日的寫法為：

<servicedate month="6" day="7" year="2023"/>

缺少<servicedate>年份和月份的評論可能無法顯示。不需要指定日期。

請注意，只有當 <title> 是 <review> 的有效子元素時， 評論的 type 是 editorial，而 <date> 只有在 type 是 user 時才有效。

範例

以下範例是部分飯店清單，其中列出 包含編輯與使用者評論：

<?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>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<attributes>

<attributes> 標記可用來描述房源設施 則為房源的評分和評論

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>

子元素

子項元素 必填與否 說明
<website> Optional 飯店的主要網站，(如果有的話) 必須放置在適當位置 在第一個 <client_attr> 元素前方。範例： 
<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Optional 額外特性或屬性有該屬性 可以使用支援的 attribute_name或 attribute_name的度假民宿。

屬性名稱預留位置的值

下表列出 attribute_name 的有效值 <client_attr name="attribute_name">元素。

attribute_name 的值 說明 有效內容值
alternate_hotel_id 房源的備用 ID。採用個別 ID 相當實用 您可能需要一個房源 ID 用於動態饋給資訊 也就是預訂引擎的其他房源 ID 任何字串值
custom_[0-4] 任何字串類型的自訂屬性。使用者不會看到這些資訊。 任何字串值
hotel_brand 這間飯店隸屬的品牌，例如「萬豪國際」或 「Hilton」。這項資訊不會向使用者顯示，但可用於分組 任何字串值
lodging 所有可用欄位的編碼表示法 Lodging proto。 已編碼 原始值：Lodging
num_reviews 商家資訊的評論數。 任何非負整數。
rating 代表匯總屬性評分的浮點數。 這個數字通常來自 0 到 5、0-10 或 0-100，但 你可以使用任何能夠代表您分級系統的範圍。

度假民宿的 attribute_name 預留位置值

請參閱度假民宿專屬的屬性和 XML 範例。

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>
            + <image>

圖片是用來在房源 ID 中顯示房源。所有使用的圖片都必須 請遵循下列指南：

  • 建議的圖片顯示比例為 4:3。
  • 圖片網址必須可供 Googlebot 圖片檢索器存取。

  • 如果你的網站在根層級加入了 robots.txt，請確認該檔案含有 您有兩個選項：

    1. 允許 Googlebot 檢索器檢索網站內容 (其中包含的圖片)。

      • User-agent: Googlebot
      • Allow: /

    2. 允許 Googlebot 圖片檢索器檢索您網站上的圖片。

      • User-agent: Googlebot-Image
      • Allow: /

  • 禁止提供圖片或網站的螢幕截圖。圖片必須是原創圖片 和實際圖片或相片

，瞭解如何調查及移除這項存取權。

屬性

  • "ad"：如果圖片為廣告
  • "menu" (如果圖片是餐廳菜單)
  • 如果圖片是商家的相片，則為 "photo"
屬性名稱 必填與否 格式 說明
type Required Text

圖片必須是下列其中之一：
url Required Text 原尺寸圖片的網址。請使用 url 屬性指定 要在頁面上使用的圖片
width Required A non-negative integer 圖片的寬度，以像素為單位 (大於 720 像素是 建議)
height Required A non-negative integer 圖片的高度，以像素為單位 (大於 720 像素是 建議)

子元素

子項元素 必填與否 說明
<link> 已要求，但在地相片商家資訊為必填屬性。 這個標記包含你網站上的有效網頁的最新網址 該圖片所在的位置但不會包含圖片本身的網址。 範例：
<link><http://www.example.com/magic_pizza/></link>
<title> 已要求 這個標記包含圖片的標題。範例： 
<title>"Luxury Apartment"</title>
<author> 非必要 內容作者的姓名。該值可以是 必須是使用者名稱或全名，格式為「Firstname 姓氏」。
<date> 必填

此標記會指出內容項目建立的日期。個人中心 都必須輸入年、月、日，如以下範例所示：

<date month="6" day="7" year="2023"/>

範例

以下是含有圖片標記的部分飯店清單範例：

<?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>
    <content>
      <review>
      </review>
      <attributes>
      </attributes>
      <image type="photo" url="https://image_url" width="400" height="300">
        <link>https://image_url</link>
        <title>Apartment at Sandstone</title>
        <author>Jessica Landlord</author>
        <date month="6" day="7" year="2023"/>
      </image>
    </content>
  </listing>
  ...
</listings>

語法指南

建立以 XML 為基礎的飯店清單時，請遵循下列準則：

  • 使用 Google 的 XSD 結構定義驗證飯店清單 XML 檔案。

  • 請使用 UTF-8 編碼，加入 encoding 來指定這個編碼結構定義 屬性，如以下範例所示。

  • 你可以在動態饋給中使用 CDATA 個部分指定資料值。如果您使用 CDATA 區段，不應逸出特殊字元。

  • 針對非 CDATA 部分的資料值使用逸出碼，包括 網址。您可以使用實體代碼或字元碼來代表 這些特殊字元 下表列出了您可以使用的常見實體和字元代碼：

    字元 實體 字元代碼
    AND 符號 (&) &amp; &#38；
    單引號 (') &apos; &#39；
    雙引號 (") &quot; &#34；
    大於 (>) &gt; &#62；
    小於 (<) &lt; &#60；

  • 省略不含資料的 XML 元素。舉例來說 飯店的經緯度，則不應留空 <latitude/> 和 <longitude/> 元素。

  • 在任何情況下，都不要在 XML 元素中使用 HTML，即使該元素 逸出)。

  • 如要在上傳前驗證動態饋給，可以使用本地動態饋給 XSD http://www.gstatic.com/localfeed/local_feed.xsd.

  • 如要在動態消息中使用註解，請將註解納入 <!-- 和 --> 標記中。 如以下範例所示：

    <!-- This is a comment -->

  • 請確認已將使用者的 <date> 元素關閉 <review>。例如：

    <date day="2" month="12" year="2017"/>