屬性

本頁面會說明屬性和屬性的說明、值及規定 子元素。這些值僅適用於度假民宿房源。

一般 XML 結構的格式與飯店房源資訊動態饋給類似。詳情請見 飯店清單 XML 參考資料。

如未加入下列必要項目，系統會自動停用 商家資訊：

  • 必要的 XML 子元素：id、name、latitude、longitude、address。
  • 必要屬性：capacity 和 website。請參閱度假民宿直接連結 在你的房源資訊動態饋給中顯示。讓使用者有機會造訪 網站。

如要進一步瞭解必要的 XML 子元素，請參閱 XML 子項元素 元素。

如要進一步瞭解度假民宿，請參閱： 度假民宿的專屬屬性。

最後，當 Google 從其他來源判斷 attribute 與 只要設定在度假民宿商家資訊的動態饋給中指定的值，Google 就會顯示 值。舉例來說，假設 Google 根據商家資訊的相片判斷 該函式有廚房，但 kitchen 屬性不存在或設為 No。 Google 會將商家資訊視為有廚房。這些屬性稱為 「推測屬性」，而且只有在可信度高的情況下才會顯示 推論準確率

屬性名稱預留位置的值

下表提供 attribute_name 的有效值清單： <client_attr name="attribute_name"> 元素；不過 建議您提供額外的attribute_name (如果有的話)。

attribute_name 的值 必填與否 說明 有效的內容值
capacity Required 飯店可容納的房客人數上限。這個值 等於或大於「數量」的臥室。 Non-negative integer value
website Required 資源的網站網址。 Free text
partner_hygiene_link Strongly recommended 點選這個連結，即可查看外部合作夥伴網站 商家資訊的健全度說明。 Free text (the site's URL)
number_of_bathrooms Strongly recommended 浴室數量。 Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended 臥室數量。 Non-negative integer value
number_of_beds Strongly recommended 所有客房的床鋪數量。 Non-negative integer value
self_checkin_checkout Recommended 房源是否開放自助入住和退房。 Yes/No/Unknown
rating Strongly recommended 代表匯總屬性評分的浮點數。這個 通常介於 0 到 5、0-10 或 0-100 的數字，但您可以使用任何範圍 代表您的分級系統。 Non-negative float value
rating_num Strongly recommended 房源的評分次數。 Non-negative integer value
rating_scale Strongly recommended 房源的評分上限 Non-negative integer value
instant_bookable Strongly recommended 房源是否可透過結帳流程立即預訂。 替代方案正在等待核准。 Yes/No/Unknown
description Strongly recommended 說明房源獨特特質的任意形式文字 Free text
category Strongly recommended 房源類型，例如度假別墅、平房、小屋或公寓 Free text
ac Recommended 資源是否有空調。 Yes/No/Unknown
beach_access Recommended 房源是否可前往鄰近 資源。 Yes/No/Unknown
check_in_time Recommended 入住飯店的確切時間。HHMM、HH:MM 或 HH:MM:SS 格式；例如使用 14:00，而不是下午 2:00 或 2:00。所有語言 系統不會剖析或顯示其他格式。 Time
check_out_time Recommended 房源退房的確切時間。HHMM、HH:MM 或 HH:MM:SS 格式；例如 11:00，而不是上午 11:00 或 11:00。所有語言 系統不會剖析或顯示其他格式。 Time
child_friendly Recommended 資源是否適合兒童。 Yes/No/Unknown
crib Recommended 資源是否提供嬰兒床。 Yes/No/Unknown
elevator Recommended 資源是否有電梯。 Yes/No/Unknown
gym_fitness_equipment Recommended 房源有健身房或任何健身器材。 Yes/No/Unknown
heating Recommended 資源是否有暖氣。 Yes/No/Unknown
hot_tub Recommended 資源是否有熱水浴缸。 Yes/No/Unknown
ironing_board Recommended 資源是否提供熨衣板。 Yes/No/Unknown
kitchen Recommended 資源是否有廚房。 Yes/No/Unknown
microwave Recommended 資源是否有微波爐。 Yes/No/Unknown
min_days_advance_purchase Recommended 可提前預訂房源的天數。 Non-negative integer value
min_night_stay Recommended 房客可以預訂的最短入住天數。 Positive integer (more than zero)
max_night_stay Recommended 房客可預訂的住宿天數上限。 Positive integer (more than zero)
outdoor_grill Recommended 資源是否有燒烤架。 Yes/No/Unknown
oven_stove Recommended 房源是否設有爐架。 Yes/No/Unknown
parking_type Recommended 飯店提供的停車位類型。 Free/Paid/None
patio Recommended 資源是否有露台。 Yes/No/Unknown
pets_allowed Recommended 部分或所有客房可讓房客攜帶寵物，包括會攜帶狗或貓的寵物 並非服務動物， Yes/No/Unknown
pool_type Recommended 房源擁有的集區 (集區存取權) 類型。 Indoors, Outdoors, Indoors/Outdoors, None
smoking_free_property Recommended 房源是否禁菸或禁止吸菸。 Yes/No/Unknown
special_service_level Recommended 商家資訊的服務層級是否有某些特別之處。 例如 verified、luxury、 premium Yes/No/Unknown
square_footage Recommended 房源面積 (平方英尺)。 Non-negative float value
square_meters Recommended 房源面積以平方公尺為單位。 Non-negative float
tv Recommended 資源是否有電視。 Yes/No/Unknown
washer_dryer Recommended 資源是否提供洗衣機。 Yes/No/Unknown
wheelchair_accessible Recommended 資源是否提供無障礙設施。 Yes/No/Unknown
internet_type Recommended 房源提供的 Wi-Fi 網際網路存取權類型。 Free/Paid/None
airport_shuttle Optional 主辦人是否提供往返機場或其他地點的運輸服務 終端機 Yes/No/Unknown
balcony Optional 資源是否有陽台。 Yes/No/Unknown
fire_place Optional 資源是否有壁爐。 Yes/No/Unknown
free_breakfast Optional 飯店是否提供免費早餐。 Yes/No/Unknown
host_description Optional 度假民宿業者的說明。 Free text
host_language Optional 主持人使用的語言。 以半形逗號分隔的清單 語言 代碼；例如：de、en
host_name Optional 度假民宿的主辦人名稱。 Free text
host_response_rate Optional 主機的平均回應率。 Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional 主機的平均回應時間。 Free text
license_num Optional 房源須顯示執照號碼 (旅遊業者或公司) 就能讓世界各地的特定機構這些容器可以重複 有哪些授權，建議新增執照的授權。 例如「巴黎：123456ABC」。 Free text
number_of_half_bathrooms Optional 半浴室數量。 Non-negative integer value
number_of_living_rooms Optional 起居室數量。 Non-negative integer value
private_beach_access Optional 資源是否擁有專屬的非公共海灘。 Yes/No/Unknown
refund_policy Optional 房源退款政策。 Free text

XML 子元素

必須提供下列 XML 子元素：

子項元素 必填與否 類型 說明
<country> Strongly recommended string 這則商家資訊的所在國家/地區。值必須是 ISO 3116 國家/地區代碼 (2 個英文字母)；例如，美國是 US 而加拿大為 CA： 
    <country>US</country>
<id> Required string 房源的專屬 ID。請注意，每間度假民宿 必須具有網站專屬的 ID，且不得 重複使用
<latitude> Required float 與商家資訊中列出的所在位置對應的緯度，適用對象 範例： 
    <latitude>37.423738</latitude>

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

您可以使用 GeoCoding 工具產生這個值，例如 Google Maps API。
<name> Required string 屬性的名稱。最多 300 個字元。
<address> Required string or Object

屬性的完整實際位置，以字串表示。地址必須包含街道名稱和門牌號碼。如果不存在，地址必須包含一個 plus code。如有公寓或門牌號碼，請一併加入。

或者，您也可以提供「複合」讓我們看看 DNS 解析 進一步探索內部和外部位址使用 <component> 位兒童 元素來描述地址的每一個部分：

  • addr1：主要街道地址。
  • addr2：如有需要，請提供次要街道地址，包括門牌號碼。
  • city：城市。
  • province：如有需要，請輸入州、地區或省。
  • postal_code：郵遞區號。
  • country：國家/地區。

請注意，訂單方塊或其他僅供郵寄的地址 視為完整的實際地址

以下是完整地址的範例：

<address> 6 Acacia Ave Apt. 2, Sidney, V8L 3B8, Canada</address>

<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

以下是使用 Plus Code 的完整地址範例：

<address>84WRMJ53+HM, Sidney, V8L 3B8, Canada</address>

<address>
  <component name="addr1">84WRMJ53+HM</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

請避免：

  • 資訊多餘：請勿加入多餘的資訊或重複的地址元件。
  • 缺少街道地址： 地址必須包含街道名稱和號碼。

度假民宿商家資訊範例

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>Apartment Name</name>
    <address format="simple">
      <component name="addr1">18733 Clark Way</component>
      <component name="addr2">#C10</component>
      <component name="city">Mountain View</component>
      <component name="postal_code">94043</component>
      <component name="province">California</component>
    </address>
    <country>US</country>
    <latitude>37.4182515</latitude>
    <longitude>-122.0742354</longitude>
    <phone type="main">12345678</phone>
    <category>vacation_villa</category>
    <date day="21" month="12" year="2017"/>
    <content>
      <text type="description">
        <link>https://list_url</link>
        <title>Description Title</title>
        <body>Description Body</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE</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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com/123456</website>
        <client_attr name="capacity">7</client_attr>
        <client_attr name="cleaning_disinfection">Yes</client_attr>
        <client_attr name="min_days_between_stays">3</client_attr>
        <client_attr name="enhanced_cleaning_practices">Yes</client_attr>
        <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr>
        <client_attr name="number_of_bathrooms">2</client_attr>
        <client_attr name="number_of_bedrooms">3</client_attr>
        <client_attr name="number_of_beds">4</client_attr>
        <client_attr name="self_checkin_checkout">Yes</client_attr>
        <client_attr name="rating">4.8</client_attr>
        <client_attr name="rating_num">5373</client_attr>
        <client_attr name="rating_scale">5</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">No</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="check_in_time">15:00</client_attr>
        <client_attr name="check_out_time">11:00</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Unknown</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Unknown</client_attr>
        <client_attr name="free_breakfast">Yes</client_attr>
        <client_attr name="gym_fitness_equipment">Yes</client_attr>
        <client_attr name="heating">Yes</client_attr>
        <client_attr name="host_description">A short description about the host and their interests</client_attr>
        <client_attr name="host_name">The name of the host</client_attr>
        <client_attr name="host_language">en, da, el</client_attr>
        <client_attr name="host_response_rate">0.75</client_attr>
        <client_attr name="host_response_time">1 hour</client_attr>
        <client_attr name="hot_tub">Yes</client_attr>
        <client_attr name="instant_bookable">Yes</client_attr>
        <client_attr name="internet_type">Free</client_attr>
        <client_attr name="ironing_board">No</client_attr>
        <client_attr name="kitchen">Yes</client_attr>
        <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr>
        <client_attr name="license_num">Paris: 123456ABC</client_attr>
        <client_attr name="microwave">Yes</client_attr>
        <client_attr name="max_night_stay">7</client_attr>
        <client_attr name="min_days_advance_purchase">2</client_attr>
        <client_attr name="min_night_stay">3</client_attr>
        <client_attr name="number_of_living_rooms">1</client_attr>
        <client_attr name="outdoor_grill">No</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Unknown</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Unknown</client_attr>
        <client_attr name="room_type">Entire Place</client_attr>
        <client_attr name="refund_policy">The refund policy for the property</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="special_service_level">No</client_attr>
        <client_attr name="square_footage">1200</client_attr>
        <client_attr name="tv">Yes</client_attr>
        <client_attr name="washer_dryer">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
      </attributes>
    </content>
  </listing>
</listings>