ホテルの構造化データのマークアップを追加する方法については、このページをご覧ください。 料金データが含まれます。
概要
ホテル料金の構造化データは、詳細な説明、検証、表示に使用されます。 ユーザー インターフェースに関係なく、ウェブサイトに表示される宿泊料金。この 基本料金、客室料金、客室料金、税金と価格に関連するフィールドです。
Google はパートナーに対して、標準化されたコードを使用してウェブページにアノテーションを付けることを推奨 クローラーが機械で読み取り可能な構造化データ提供元 schema.org を使用して価格を正確にスクレイピングする 防ぐことができます
これにより、サービス品質を改善して料金精度の検証を 向上させることができます。利点は、指標の量が 料金精度の検証と、料金精度の問題をデバッグする機能 料金精度スコアの一貫性も確保されます
構造化データを初めて使用する場合は、構造化データの語彙についてご覧ください。 指定されています。
Google ホテルでは、ウェブページにアノテーションを付ける際に JSON-LD 形式を推奨しています。詳しくは、
サポートされている形式
をご覧ください。このドキュメントでは、
ホテルでの構造化データの実装に固有の詳細なリファレンス コンテンツです。
Hotel 構造化データは、
表示されます。Hotel 構造化データには、次のプロパティがあります。
nameとaddressプロパティmakesOfferプロパティHotel priceSpecificationプロパティhasMerchantReturnPolicyプロパティeligibleCustomerTypeプロパティ
HotelRoom 構造化データは、会議室固有のフィールドにアノテーションを付けるために使用されます。
追加できます
HotelRoom 構造化データには、次のプロパティがあります。
offersプロパティbedおよびoccupancyプロパティincludesObjectプロパティavailabilityプロパティamenityFeatureプロパティ
ホテルの構造化データ
name プロパティと address プロパティ
name プロパティと address プロパティは、ホテル名にアノテーションを付けるために使用されます。
あります。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 Chat では 1 つの旅行プランに複数のオファーを指定しますが、 最初に 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 件の宿泊施設
ホテルまたはホテルの料金情報にアノテーションを付けるために使用されます
あります。アセットにアノテーションを付けるには、追加のプロパティが 2 つ必要です。
価格や税金も考慮します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"
}
]
}
}
}
microdata
<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 ではホテルレベルと客室レベルの両方を受け入れます 提供します。 |
| Hotel.Offer.priceSpecification.priceCurrency | Required | currency | 指定された価格を表す 3 文字の通貨コード。(例: "USD"
)。 |
| Hotel.Offer.priceSpecification.priceComponent | Optional | UnitPriceSpecification[] | ホテルの合計料金の内訳(税金と手数料を含む)。 価格構造化データには次の 2 種類があります。
|
| 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 さんの受信者の種類。
パッケージの合計金額は $1,170 で、オンラインのウェブサイトでは一部が請求されています。
"@type": "OnlineBusiness"。ユーザーは残りの 20 ドルを
ホテルのチェックイン時刻です。
@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": { ... }
}
}
}
]
}
}
}
microdata の例
価格の詳細
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 | 販売者の払い戻しポリシー。パートナー様は
|
例
返品に関するポリシー
部屋のあるホテルの構造化データの基本的な例を次に示します。
合計金額(税金と手数料を含む)が表示されます。この例は宿泊を示しています。
キャンセル可能(料金は発生しません)
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 | ユーザーのタイムゾーンでのチェックアウト時刻。タイムゾーンが異なる場合 ホテルのタイムゾーンが考慮されます。 |
例
表示
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"
},
...
}
}
}
}
bed プロパティと occupancy プロパティは、HotelRoom
プロパティです。客室固有の情報(客室レベルの料金など)を含めることができます。
containsPlace プロパティを通じて Hotel プロパティに紐付けます。詳しくは、
Hotel と HotelRoom の指定の例。
プロパティ
bed プロパティと occupancy プロパティは次のとおりです。
| プロパティ | 必須 | 型 | 説明 |
|---|---|---|---|
| HotelRoom.bed | Optional (Recommended) | bed | 宿泊施設に含まれるベッドの種類と台数 確保できます。 サポートされている値は次の通りです。
|
| HotelRoom.occupancy | Optional (Recommended) | QuantitativeValue | ホテルの客室の宿泊客の数。宿泊人数のタイプは
Occupancy は
|
| 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"
}
}
}
Hotel と 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 | 税金と手数料を含む 1 室あたりの料金
ランディング ページには、必ず料金とともに 料金の詳細が表示されます。料金の詳細にアノテーションを付けると 料金精度チェックGoogle ではホテルレベルと客室レベルの両方を受け入れます 提供します。 |
| Hotel.Offer.priceSpecification.priceCurrency | Required | currency | 指定された価格を表す 3 文字の通貨コード。(例: "USD"
)。 |
| Hotel.Offer.priceSpecification.priceComponent | Optional | UnitPriceSpecification[] | ホテルの合計料金の内訳(税金と手数料を含む)
|
例
客室料金の合計
長さの合計価格を定義する基本的な例は、次のとおりです。 1 人あたりの料金です
{
"@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" は、サービスのタイプを示すために使用します。
あります。
{
"@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 | ホテルまたは客室の空室状況。 料金は から抽出されます
|
例
対象
ホテルの客室が利用できない場合の基本的な例を次に示します。マイページ ベッドタイプ、ベッド数、定員の詳細を含める必要があります 割り当てることができます。
{
"@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 | 宿泊施設は購入手続きですぐに予約できるかどうか プロセスです代替手段は承認待ちです。 |
| 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"
}
}
}
}