本頁說明如何為飯店加上結構化資料標記 價格資料。
總覽
飯店價格結構化資料用於提供詳細解說、驗證及顯示詳細資料 網站中列出的飯店價格,不論使用者介面為何。這個 價格、房價、客房、手續費及稅金和價格相關欄位
Google 建議合作夥伴使用標準化版在網頁上加註 可供檢索器讀取的結構化資料提供者: schema.org,以便準確抓取價格 。
這樣一來,您就能透過改善 可靠的檢索器可靠性。這麼做有利於您提高 驗證價格準確度,並能對價格準確度問題進行偵錯 且價格準確度分數維持一致
如果您是第一次使用結構化資料,請進一步瞭解結構化資料詞彙 以及格式
Google 飯店建議採用 JSON-LD
格式為您的網頁加註。詳情請參閱
支援的格式
。本文件提供
飯店結構化資料專屬的詳細參考內容。
Hotel
結構化資料可用來為
網頁。Hotel
結構化資料具備下列屬性:
makesOffer
敬上 資源eligibleCustomerType
敬上 資源
HotelRoom
結構化資料可用來為
您的網頁
HotelRoom
結構化資料具備下列屬性:
offers
敬上 資源includesObject
敬上 資源availability
敬上 資源amenityFeature
敬上 資源
飯店結構化資料
name
和 address
資源
name
和 address
屬性可用於為飯店的名稱加上註解
或 HTTP/HTTPS 位置以下是 name
和 address
屬性:
"@type": "Hotel",
"name": "hotel-name",
"identifier": "hotel-id-1234",
"address": {
"@type": "PostalAddress",
"addressCountry": "XX",
"addressLocality": "City Name",
"addressRegion": "State Name",
"postalCode": "01234",
"streetAddress": "1234 Main St."
},
語法
name
和 address
屬性使用下列語法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "hotel-name",
"identifier": "hotel-id-1234",
"address": {
"@type": "PostalAddress",
"addressCountry": "XX",
"addressLocality": "City Name",
"addressRegion": "State Name",
"postalCode": "01234",
"streetAddress": "1234 Main St."
},
"makesOffer": {
"@type": ["Offer", "LodgingReservation"]
...
}
}
屬性
以下是 name
和 address
屬性:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
Hotel.name | Required | string | 飯店名稱 |
Hotel.identifier | Required | string | 合作夥伴飯店 ID。 每間飯店的 ID 必須是專屬字串,且應完全相符 與價格動態饋給中使用的字串相符。 |
Hotel.address | Optional | PostalAddress | 飯店的地址或地點。 |
範例
名稱與地址
以下是新增 name
和 address
註解的基本範例:
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "Mountain Hotel",
"identifier": "hotel-id-1234",
"address": {
"@type": "PostalAddress",
"addressCountry": "AT",
"addressLocality": "Innsbruck",
"addressRegion": "Tyrol",
"postalCode": "6020",
"streetAddress": "Technikerstrasse 21"
},
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
}
}
makesOffer
資源
makesOffer
註解的用途是標記
找出您的飯店行程
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"availability": "https://schema.org/InStock",
...
}
語法
makesOffer
屬性使用下列語法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "hotel-name",
"identifier": "hotel-id-1234",
"address": { ... },
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"availability": "https://schema.org/InStock",
"priceSpecification": { ... }
}
}
屬性
makesOffer
屬性如下:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
makesOffer | Required | Offer and LodgingReservation | 指定行程的飯店優惠。
|
LodgingReservation.checkinTime | Required | DateTime | 以使用者所在時區的入住時間。如果您的時區不是 會納入飯店時區 |
LodgingReservation.checkoutTime | Required | DateTime | 退房時間 (以使用者時區為準)。如果您的時區不是 會納入飯店時區 |
範例
makesOffer
以下是加上飯店優惠註解的基本範例。你可以 為行程指定多項優惠,但您應該指定 Google 顯示費率,後面接著其他費率。價格金額 包括所有適用稅金。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "Mountain Hotel",
"identifier": "hotel-id-1234",
"address": { ... },
"makesOffer": [
{
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
},
{
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1200.74,
"priceCurrency": "USD"
}
}
]
}
Hotel priceSpecification
資源
這個屬性可用來加註飯店或飯店的房價資訊
個房間您還需要兩個額外的屬性
售價與稅金。應使用 CompoundPriceSpecification
指定總價,例如基本費率、稅金和折扣。
使用 UnitPriceSpecification
指定額外的稅金或特殊費用類型
例如 ResortFee
、GenericTax
和 ServiceFee
priceSpecification
屬性隨附於 Offer
屬性
{
...
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": "float",
"priceCurrency": "currency"
},
...
]
}
}
語法
Hotel priceSpecification
屬性使用下列語法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
...
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
...
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "",
"price": "float",
"priceCurrency": "currency"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": "float",
"priceCurrency": "currency",
"priceComponentType": "GenericTax",
"potentialAction": {
"@type": "https://schema.org/PayAction",
"recipient": {
"@type": "OnlineBusiness",
"name": "name-of-the-business"
}
}
},
{
"@type": "UnitPriceSpecification",
"name": "Discount",
"price": "float",
"priceCurrency": "currency",
"priceComponentType": "Discount"
}
]
}
}
}
微資料
<div itemscope itemtype="https://schema.org/Hotel">
<meta itemprop="name" content="hotel-name"/>
...
<div itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation" itemprop="makesOffer">
...
<div itemscope itemtype="https://schema.org/CompoundPriceSpecification" itemprop="priceSpecification">
<meta itemprop="price" content="float"/>
<meta itemprop="priceCurrency" content="currency"/>
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content=""/>
<meta itemprop="price" content="float"/>
<meta itemprop="priceCurrency" content="currency"/>
</div>
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content="GenericTax" />
<meta itemprop="price" content="float"/>
<meta itemprop="priceCurrency" content="currency"/>
<meta itemprop="priceComponentType" content="GenericTax"/>
</div>
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content="Discount"/>
<meta itemprop="price" content="float"/>
<meta itemprop="priceCurrency" content="currency"/>
<meta itemprop="priceComponentType" content="Discount"/>
</div>
</div>
</div>
</div>
屬性
hotel priceSpecification
屬性如下:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
Hotel.Offer.priceSpecification.price | Required | float | 飯店的總價 (含稅金和相關費用)。 到達網頁上應一律加註 Google 費率和 你的完整房價詳細資料為費率詳細資料加上註解 價格準確度檢查。Google 接受飯店層級和客房層級這兩項設定 價格。 |
Hotel.Offer.priceSpecification.priceCurrency | Required | currency | 指定價格的三字母貨幣代碼。例如:"USD"
。 |
Hotel.Offer.priceSpecification.priceComponent | Optional | UnitPriceSpecification[] | 飯店的總價明細 (包含稅金和相關費用)。 價格結構化資料分為以下兩種類型:
您必須在 |
Hotel.Offer.priceSpecification.priceComponent. potentialAction | Optional | PayAction | 飯店付款方式,包括房價 在退房期間和 入住期間的飯店。 建議您使用 Google 支援以下兩項
|
範例
JSON-LD 範例
價格
以下是在網頁中加入價格結構化資料的基本範例
網頁。多項飯店層級優惠可加到
makesOffer
屬性。
PostalAddress
類型,例如 addressCountry
、postalCode
streetAddress
以及其他欄位,如果選擇指定
address
屬性。Google 顯示的費率應先列於
makesOffer
屬性。指定的價格金額含括所有適用的
稅金。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"address": {
"@type": "PostalAddress",
"addressCountry": "AT",
"addressLocality": "Innsbruck",
"addressRegion": "Tyrol",
"postalCode": "6020",
"streetAddress": "Technikerstrasse 21"
},
"makesOffer": [
{
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
},
{
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1200.74,
"priceCurrency": "USD"
}
},
...
]
}
價格明細
以下是使用 priceSpecification
屬性的
價格明細基本費率 (一般稅金和折扣等稅金) 為
使用 UnitPriceSpecification
元件定義。記得使用
priceComponentType
欄位,其中包含與
UnitPriceSpecification
元件。
如要指定入住天數的總價,請在
CompoundPriceSpecification
屬性。價格細目應為
在 priceComponent
屬性中指定的。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"address": {...},
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "",
"price": 1150,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": 172.74,
"priceCurrency": "USD",
"priceComponentType": "GenericTax"
},
{
"@type": "UnitPriceSpecification",
"name": "Discount",
"price": -100,
"priceCurrency": "USD",
"priceComponentType": "Discount"
}
]
}
}
}
聯絡窗口
以下是使用potentialAction
PayAction
的收件者類型。
套裝方案的總價為 $1170 美元,線上網站收費
的總價即為 $1150 美元
"@type": "OnlineBusiness"
,而使用者須在
入住飯店的入住時間,使用
@type": "Hotel"
。
您必須指定 potentialAction
元件才能細分
在預訂時和飯店付款。如果沒有指定
「payAction
」會將訂票時的付款金額解讀為預設值
付款方式。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00]",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1170,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"price": 1150,
"priceCurrency": "USD",
"potentialAction": {
"@type": "https://schema.org/PayAction",
"recipient": {
"@type": "OnlineBusiness",
"name": "myonlinebusiness"
}
}
},
{
"@type": "UnitPriceSpecification",
"price": 20,
"priceCurrency": "USD",
"potentialAction": {
"@type": "https://schema.org/PayAction",
"recipient": {
"@type": "Hotel",
"name": "The Langham, Boston",
"address": { ... }
}
}
}
]
}
}
}
微資料範例
價格明細
以下是使用 priceSpecification
屬性的
價格明細基本費率 (一般稅金和折扣等稅金) 為
使用 UnitPriceSpecification
元件定義。記得使用
name
屬性,其中包含與
UnitPriceSpecification
元件。
如要指定入住天數的總價,請在
CompoundPriceSpecification
屬性。價格細目應為
在 priceComponent
屬性中指定的。
<div itemscope itemtype="https://schema.org/Hotel">
<meta itemprop="name" content="ACME Hotel"/>
<meta itemprop="identifier" content="hotel-id-1234"/>
<div itemscope itemtype="https://schema.org/PostalAddress" itemprop="address">
<meta itemprop="addressCountry" content="US" />
<meta itemprop="addressLocality" content="Mountain View" />
<meta itemprop="addressRegion" content="Santa Clara" />
<meta itemprop="postalCode" content="94040" />
<meta itemprop="streetAddress" content="123 Main street" />
</div>
<div itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation" itemprop="makesOffer">
<meta itemprop="checkinTime" content="2023-03-10 15:00:00" />
<meta itemprop="checkoutTime" content="2023-03-16 10:00:00"/>
<div itemscope itemtype="https://schema.org/CompoundPriceSpecification" itemprop="priceSpecification">
<meta itemprop="price" content="1222.74" />
<meta itemprop="priceCurrency" content="USD" />
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content="" />
<meta itemprop="price" content="1150" />
<meta itemprop="priceCurrency" content="USD" />
</div>
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content="GenericTax" />
<meta itemprop="price" content="172.74" />
<meta itemprop="priceCurrency" content="USD" />
<meta itemprop="priceComponentType" content="GenericTax" />
</div>
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content="Discount" />
<meta itemprop="price" content="-100" />
<meta itemprop="priceCurrency" content="USD" />
<meta itemprop="priceComponentType" content="Discount" />
</div>
</div>
</div>
</div>
hasMerchantReturnPolicy
資源
這項屬性可在行程中加註商家退款政策。
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"refundType": "https://schema.org/FullRefund",
"merchantReturnDays": "YYYY-MM-DD[THH:mm:ss]",
"restockingFee": 0
}
語法
hasMerchantReturnPolicy
的語法如下:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
...
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"priceSpecification": { ... },
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"refundType": "https://schema.org/FullRefund",
"merchantReturnDays": "YYYY-MM-DD[THH:mm:ss]",
"restockingFee": 0
}
}
}
屬性
以下是 hasMerchantReturnPolicy
屬性:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
Offer.hasMerchantReturnPolicy | Optional | MerchantReturnPolicy | 商家退款政策。合作夥伴應使用
如未指定 |
範例
退貨政策
以下為提供客房的飯店結構化資料基本範例
詳細資料和總價 (含稅金和相關費用)。此範例表示住宿
可取消訂閱,結束時間為世界標準時間晚上 11 點 (世界標準時間)
2023 年 12 月 18 日。合作夥伴應使用
"MerchantReturnPolicy.restockingFee"
:表示取消政策
全額退款無法全額退還。restockingFee
預設值
至 $0。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"description": "Beautiful resort in the outskirts of the city",
"address": {...},
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-12-15 16:00:00",
"checkoutTime": "2023-12-20 11:00:00",
"priceSpecification": {...},
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"refundType": "https://schema.org/FullRefund",
"merchantReturnDays": "2023-12-18 23:00:00",
"restockingFee": 0
}
}
}
eligibleCustomerType
資源
這個房源可加註飯店的獎勵計畫 會員客戶。
"eligibleCustomerType": "RewardsMember",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency"
}
語法
eligibleCustomerType
屬性的語法如下:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
...
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"eligibleCustomerType": "RewardsMember",
"priceSpecification": { ... }
}
}
屬性
以下是 eligibleCustomerType
屬性:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
Offer.eligibleCustomerType | Optional | BusinessEntityType | 專為 以更全面、準確的方式回答顧客問題 並與顧客自然流暢地對話 許多飯店網頁都會同時顯示會員費率和公開費率。 可以鼓勵使用者註冊會員方案費率受限 會員費率等特定目標對象Offer.eligibleCustomerType 屬性。 |
範例
會員費率
以下是會員價格或圍欄費率的基本示例 會員方案的規格客戶為「獎勵會員」/ 飯店。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"address": {...},
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"name": "RewardsMember",
"checkinTime": "2023-12-15 16:00:00",
"checkoutTime": "2023-12-20 11:00:00",
"eligibleCustomerType": "RewardsMember",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1342.74,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "Base rate",
"price": 1069.98,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": 172.74,
"priceCurrency": "currency"
},
{
"@type": "UnitPriceSpecification",
"name": "ResortFee",
"price": 100,
"priceCurrency": "USD"
}
]
}
}
}
成員與一般費率
這是一般費率和會員費率的註解範例。 會員價格會先列出,接著依一般費率計費。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"address": {...},
"makesOffer": [
{
"@type": ["Offer", "LodgingReservation"],
"name": "RewardsMember",
"checkinTime": "2023-12-15 16:00:00",
"checkoutTime": "2023-12-20 11:00:00",
"eligibleCustomerType": "RewardsMember",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1342.74,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "Base rate",
"price": 1069.98,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": 172.74,
"priceCurrency": "currency"
},
{
"@type": "UnitPriceSpecification",
"name": "ResortFee",
"price": 100,
"priceCurrency": "USD"
}
]
}
},
{
"@type": ["Offer", "LodgingReservation"],
"name": "regularRate",
"checkinTime": "2023-12-15 16:00:00",
"checkoutTime": "2023-12-20 11:00:00",
"priceSpecification": {
"price": 1572.24,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "Base rate",
"price": 1369.98,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": 202.26,
"priceCurrency": "currency"
},
{
"@type": "UnitPriceSpecification",
"name": "ResortFee",
"price": 100,
"priceCurrency": "USD"
}
]
}
}
]
}
HotelRoom 結構化資料
offers
資源
offers
註解用於標記你的會議室
行程。您應針對 HotelRoom
規格使用 offers
屬性。
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "hotel-room-id-1234",
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"priceSpecification": {...}
}
語法
offers
屬性的語法如下:
JSON-LD
{
"@context": "https://schema.org",
"@type": "HotelRoom",
"identifier": "hotel-room-id-1234",
"offers": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
...
}
}
}
屬性
offers
屬性如下:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
offers | Required | Offer and LodgingReservation | 指定行程的房價規格。
|
LodgingReservation.checkinTime | Required | DateTime | 以使用者所在時區的入住時間。如果您的時區不是 會納入飯店時區 |
LodgingReservation.checkoutTime | Required | DateTime | 退房時間 (以使用者時區為準)。如果您的時區不是 會納入飯店時區 |
範例
offers
以下是在 HotelRoom
中指定 offers
的基本範例
資源。
{
"@context": "https://schema.org",
"@type": "HotelRoom",
"identifier": "hotel-room-id-1234",
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
}
}
bed
和 occupancy
資源
bed
屬性可用於新增床型和床鋪數的註解
空房。occupancy
屬性是用來為數字加註
參與者人數bed
和 occupancy
屬性可以使用
HotelRoom
屬性。
"@type": "Hotel",
"identifier": "hotel-id-1234",
"containsPlace": {
"@type": ["HotelRoom", "Product"],
"identifier": "hotel-room-id",
"bed": {
"@type": "BedDetails",
"numberOfBeds": "integer",
"typeOfBed": "KING"
},
"occupancy": {
"@type": "QuantitativeValue",
"value": "integer"
}
}
語法
bed
和 occupancy
屬性的語法如下:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "hotel-name",
"identifier": "hotel-id-1234",
"containsPlace": {
"@type": ["HotelRoom", "Product"],
"name": "room-name",
"identifier": "hotel-room-id-1234",
"bed": {
"@type": "BedDetails",
"numberOfBeds": "integer",
"typeOfBed": "KING"
},
"occupancy": {
"@type": "QuantitativeValue",
"value": "integer"
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
"priceComponent": {
"@type": "UnitPriceSpecification",
"name": "",
"price": "float",
"priceCurrency": "currency"
},
...
}
}
}
}
只能使用 HotelRoom
設定 bed
和 occupancy
屬性
資源。可加入客房專屬資訊,包括房價等
透過 containsPlace
屬性傳送至 Hotel
屬性。詳情請參閱
Hotel
和 HotelRoom
規格範例。
屬性
以下是 bed
和 occupancy
屬性:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
HotelRoom.bed | Optional (Recommended) | bed | 住宿包含的床型和入住天數 以住客為準 支援的值如下:
|
HotelRoom.occupancy | Optional (Recommended) | QuantitativeValue | 飯店客房的房客人數。可住人數的類型是
|
containsPlace | Optional (Recommended) | LocationFeatureSpecification | 可用來加註與特定房型相關的客房層級費率 個房間你也可以使用這項屬性指定房間內的設備。 進一步瞭解如何在「」使用「 |
範例
HotelRoom
以下是客房的床鋪和可住人數基本範例 規格。
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room, 1 King Bed",
"identifier": "hotel-room-id-1234",
"bed": [
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "KING"
},
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "SINGLE"
}
],
"occupancy": {
"@type": "QuantitativeValue",
"value": 2
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
}
}
飯店和 HotelRoom
以下範例說明如何將 Hotel
和 HotelRoom
加上註解
與 bed
、occupancy
和 priceSpecification
一起使用。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "hotel-name",
"identifier": "hotel-id-1234",
"containsPlace": {
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room, 1 King Bed",
"identifier": "hotel-room-id",
"bed": {
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "KING"
},
"occupancy": {
"@type": "QuantitativeValue",
"value": 2
},
"amenityFeature": {
"@type": "LocationFeatureSpecification",
"name": "Minibar",
"value": true
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
}
}
}
HotelRoom priceSpecification
資源
飯店房價規格與飯店價格規格類似。
差別在於房間價格是使用 Product.offers
屬性指定
而不是 Hotel.makesOffer
屬性。
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
"priceComponent": {
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": "float",
"priceCurrency": "currency"
}
...
}
語法
飯店客房的 priceSpecification
屬性語法如下:
JSON-LD
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
...
"bed": {
"@type": "BedDetails",
"numberOfBeds": "integer",
"typeOfBed": "KING"
},
"occupancy": {
"@type": "QuantitativeValue",
"value": "integer"
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
...
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "",
"price": "float",
"priceCurrency": "currency"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": "float",
"priceCurrency": "currency",
"priceComponentType": "GenericTax"
},
{
"@type": "UnitPriceSpecification",
"name": "Discount",
"price": "float",
"priceCurrency": "currency",
"priceComponentType": "Discount"
}
]
}
}
}
屬性
HotelRoom priceSpecification
屬性如下:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
Hotel.Offer.priceSpecification.price | Required | float | 每間客房的價格,包含稅金和
到達網頁上應一律加註 Google 費率和 你的完整房價詳細資料為費率詳細資料加上註解 價格準確度檢查。Google 接受飯店層級和客房層級這兩項設定 價格。 |
Hotel.Offer.priceSpecification.priceCurrency | Required | currency | 指定價格的三字母貨幣代碼。例如:"USD"
。 |
Hotel.Offer.priceSpecification.priceComponent | Optional | UnitPriceSpecification[] | 飯店的總價明細 (包含稅金和相關費用)
客房和可住人數,並提供與
|
範例
客房總價
以下是定義長度總價的基本範例 入住天數和每人入住價格
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room King, 1 Single Bed",
"identifier": "hotel-room-id-1234",
"bed": [
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "KING"
},
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "SINGLE"
}
],
"occupancy": {
"@type": "QuantitativeValue",
"value": 2
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1232.74,
"priceCurrency": "USD"
}
},
...
}
房價明細
以下舉例說明每間客房或方案的價格。價格明細
已定義房間類型,例如「Deluxe
」房間以及「bed
」和「occupancy
」
類型,例如 KING
和 SINGLE
張床,以及 2 位房客可住人數。
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room King, 1 Single Bed",
"identifier": "hotel-room-id-1234",
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"bed": [
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "KING"
},
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "SINGLE"
}
],
"occupancy": {
"@type": "QuantitativeValue",
"value": 2
},
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "Base rate",
"price": 1150,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": 172.74,
"priceCurrency": "USD",
"priceComponentType": "GenericTax"
},
{
"@type": "UnitPriceSpecification",
"name": "Discount",
"price": -100,
"priceCurrency": "USD",
"priceComponentType": "Discount"
}
]
}
}
}
includesObject
資源
飯店可以為飯店提供的房價專屬服務加上註解
餐點和代客泊車服務等房間你可以新增註解
Hotel
或 HotelRoom
屬性中的 includesObject
。
{
"includesObject": [
{
"@type": "TypeAndQuantityNode",
"typeOfGood": {
"@type": "Service",
"name": "Valet"
}
},
{
"@type": "TypeAndQuantityNode",
"amountOfThisGood": "float",
"unitText": "currency",
"typeOfGood": {
"@type": "FoodService",
"name": "MealCredit"
}
}
]
}
語法
includesObject
針對特定費率服務採用下列語法
有空房:
JSON-LD
{
"@context": "https://schema.org",
...
"@type": ["HotelRoom", "Product"],
...
"offers": {
"@type": ["Offer", "LodgingReservation"],
...
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency"
},
"includesObject": [
{
"@type": "TypeAndQuantityNode",
"typeOfGood": {
"@type": "Service",
"name": "Valet"
}
},
{
"@type": "TypeAndQuantityNode",
"amountOfThisGood": "float",
"unitText": "currency",
"typeOfGood": {
"@type": "FoodService",
"name": "MealCredit"
}
}
]
}
}
屬性
includesObject
包含下列屬性:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
Offer.includesObject | Optional | TypeAndQuantityNode | 飯店或客房提供的服務。 費率專屬功能隨附於
基本等級優惠可能會包含費率專屬功能 或指定為附加費用的附加內容
|
範例
服務
以下是代客停車費率特色的基本示例
和餐飲服務費率專屬的功能應使用
"Offer.includesObject"
屬性。
"TypeAndQuantityNode.typeOfGood"
應用於表示
課程中也會快速介紹 Memorystore
這是 Google Cloud 的全代管 Redis 服務
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room, 1 King Bed",
"identifier": "hotel-room-id-1234",
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
},
"includesObject": [
{
"@type": "TypeAndQuantityNode",
"typeOfGood": {
"@type": "Service",
"name": "Valet"
}
},
{
"@type": "TypeAndQuantityNode",
"amountOfThisGood": 50,
"unitText": "USD",
"typeOfGood": {
"@type": "FoodService",
"name": "MealCredit"
}
}
]
}
}
availability
資源
offer.availability
屬性可用來為售完的行程加上註解
尋找飯店房間
"offers": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"availability": "https://schema.org/SoldOut"
}
語法
availability
屬性的語法如下:
JSON-LD
{
"@context": "https://schema.org",
...
"@type": ["HotelRoom", "Product"],
"name": "room-type",
"identifier": "hotel-room-id-1234",
"bed": {
"@type": "BedDetails",
"numberOfBeds": "integer",
"typeOfBed": "KING"
},
"occupancy": {
"@type": "QuantitativeValue",
"value": "integer"
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"availability": "https://schema.org/SoldOut"
}
}
屬性
availability
屬性如下:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
Offer.availability | Optional | ItemAvailability | 飯店或客房的空房資訊。 費率擷取自
沒有
|
範例
可用性
以下範例顯示飯店空房無法預訂的情形。個人中心 應包含床型、床鋪數量和可住人數詳細資料 指定等候室的 Pod 數量
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room, 1 King Bed",
"identifier": "hotel-room-id-1234",
"bed": [
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "KING"
},
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "SINGLE"
}
],
"occupancy": {
"@type": "QuantitativeValue",
"value": 2
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"availability": "https://schema.org/SoldOut",
"priceSpecification": {...}
}
}
amenityFeature
資源
您可以使用 Hotel
或 HotelRoom
類型,使用
amenityFeature
屬性。您應使用 containsPlace
屬性來指定
客房提供。
{
"@type": "Hotel",
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "HotTub",
"hoursAvailable": {
"@type": "OpeningHoursSpecification",
"opens": "HH:mm:ss",
"closes": "HH:mm:ss"
}
},
{
"@type": "LocationFeatureSpecification",
"name": "GymFitnessEquipment",
"value": "boolean"
}
],
"containsPlace": {
"@type": "HotelRoom",
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "Minibar",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Smoking",
"value": false
}
]
}
}
語法
amenityFeature
和 containsPlace
屬性包含下列內容
語法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
...
"amenityFeature": {
"@type": "LocationFeatureSpecification",
"name": "HotTub",
"hoursAvailable": {
"@type": "OpeningHoursSpecification",
"opens": "HH:mm:ss",
"closes": "HH:mm:ss"
}
},
"containsPlace": {
"@type": "HotelRoom",
"amenityFeature": {
"@type": "LocationFeatureSpecification",
"name": "Minibar",
"value": "boolean"
}
}
}
設施
name
屬性允許及定義下列設施。
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
amenityFeature.AC | Optional | boolean | 資源是否有空調。 |
amenityFeature.AirportShuttle | Optional | boolean | 主辦人是否提供往返機場的接駁服務,或是 和其他終端機 |
amenityFeature.Balcony | Optional | boolean | 住宿是否設有陽台。 |
amenityFeature.BeachAccess | Optional | boolean | 資源是否可通往附近的公共海灘。 |
amenityFeature.ChildFriendly | Optional | boolean | 資源是否適合兒童。 |
amenityFeature.Crib | Optional | boolean | 資源是否提供嬰兒床。 |
amenityFeature.Elevator | Optional | boolean | 資源是否有電梯。 |
amenityFeature.FirePlace | Optional | boolean | 住宿是否設有壁爐。 |
amenityFeature.FreeBreakfast | Optional | boolean | 飯店是否為所有房客提供免費早餐。使用 房價功能,指出是否僅以特定費率計費 方案。 |
amenityFeature.GymFitnessEquipment | Optional | boolean | 房源有健身房或任何健身器材。 |
amenityFeature.Heating | Optional | boolean | 住宿是否附暖氣。 |
amenityFeature.HotTub | Optional | boolean | 資源是否有熱水浴缸。 |
amenityFeature.InstantBookable | Optional | boolean | 房源是否可透過結帳立即預訂 上傳資料集之後,您可以運用 AutoML 自動完成部分資料準備工作替代方案正在等待核准。 |
amenityFeature.IroningBoard | Optional | boolean | 資源是否提供熨衣板。 |
amenityFeature.Kitchen | Optional | boolean | 客房內是否有廚房。 |
amenityFeature.Microwave | Optional | boolean | 住宿是否提供微波爐。 |
amenityFeature.OpenAirBath(Hotels only) | Optional | boolean | 住宿是否附有露天浴池。指定時 且該浴場僅供房客入住,且不得對外公開。 |
amenityFeature.OutdoorGrill | Optional | boolean | 資源是否有燒烤架。 |
amenityFeature.OvenStove | Optional | boolean | 房源是否設有爐架。 |
amenityFeature.Patio | Optional | boolean | 資源是否有露台。 |
amenityFeature.Pool | Optional | boolean | 旅宿是否設有泳池。 |
amenityFeature.PrivateBeachAccess | Optional | boolean | 資源是否擁有專屬的非公共海灘。 |
amenityFeature.SelfCheckinCheckout | Optional | boolean | 房源是否支援自行入住和退房。 |
amenityFeature.WasherDryer | Optional | boolean | 住宿中是否有洗衣設備。 |
amenityFeature.Wifi | Optional | boolean | 房源是否提供 Wi-Fi。 |
amenityFeature.Smoking | Optional | boolean | 住宿是否允許吸菸。 |
amenityFeature.InternetType | Optional | Enum | 資源中可用的網際網路類型。 支援的值如下:
|
amenityFeature.ParkingType | Optional | Enum | 飯店提供的停車位類型。 支援的值如下:
|
amenityFeature.PoolType | Optional | Enum | 資源中可用的集區類型。 支援的值如下:
|
amenityFeature.RoomStyle | Optional | Enum | 用於表示客房是否為日式設計。 支援的值如下:
|
amenityFeature.LicenseNum | Required | string | 要在房源中顯示的商家執照號碼
就能讓世界各地的特定機構可重複使用
現有的授權,建議您新增
授權。例如: |
屬性
amenityFeature
屬性如下:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
amenityFeature | Optional | LocationFeatureSpecification | 飯店或客房中提供的設施。可以指定
使用 您可以在 |
containsPlace | Optional | LocationFeatureSpecification | 所有飯店房客都能入住的飯店或房間。這項服務
可以使用 「 「 |
範例
飯店和客房設施
以下是上午 10 點至下午 10 點的飯店範例 飯店內沒有健身房。飯店客房禁煙 且設有迷你吧
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"address": { ... },
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "HotTub",
"hoursAvailable": {
"@type": "OpeningHoursSpecification",
"opens": "10:00:00",
"closes": "22:00:00"
}
},
{
"@type": "LocationFeatureSpecification",
"name": "GymFitnessEquipment",
"value": false
}
],
"containsPlace": {
"@type": "HotelRoom",
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "Minibar",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Smoking",
"value": false
}
],
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
}
}
}