ホテル料金の構造化データのリファレンス

このページでは、Schema.org のホテルに関する構造化データ マークアップの技術仕様と語彙リファレンスについて説明します。

注: ナビゲーション タグ付けと microdata を使用してウェブサイトで料金の精度を自動的に検証するには、クローラのナビゲーションと料金タグ付けのガイドをご覧ください。

概要

ホテル料金の構造化データは、ウェブサイトに掲載されているホテル料金を説明、検証、表示するための標準化された機械可読形式を提供します。これにより、ビジュアル レイアウトに関係なく、ホテル料金を正確に表示できます。これには、基本料金、料金、客室の仕様、手数料と税金の明細、予約ポリシーが含まれます。

Google では、ウェブページから価格を正確に抽出するために、Schema.org が提供する標準化された構造化データでウェブページにアノテーションを付けることをおすすめします。

標準の構造化データを使用すると、クローラーの信頼性を高め、料金の精度検証の回数を増やし、料金の精度に関する問題を直接デバッグし、料金の精度スコアの一貫性を維持することで、料金の精度検証をスケーリングできます。

注: スクレイピングとインデックス登録に関する一般的な質問については、Google 検索のクロールとインデックス登録に関するよくある質問をご覧ください。

構造化データを初めて使用する場合は、構造化データのボキャブラリと形式をご覧ください。

Google ホテルでは、ホテル料金の精度を確認するために、ウェブページにアノテーションを付ける際は、デフォルトで Microdata 形式を使用することをおすすめします。JSON-LD 形式は、料金の精度検証で非推奨になりました。この推奨事項は、ホテル料金の正確性の検証にのみ適用され、Google 全体での構造化データの他の使用方法（Google 検索のリッチリザルトなど）には影響しません。一般的な検索機能でサポートされている形式について詳しくは、サポートされている形式をご覧ください。このドキュメントでは、ホテルでの構造化データの実装に特化した詳細なリファレンス コンテンツを提供します。

キーポイント: Microdata は、ホテル料金の精度を検証するためのデフォルトの推奨形式です。JSON-LD は、ホテルの料金の検証では非推奨となり、以前の参照でのみ使用されます。

Hotel 構造化データは、ウェブページのホテル固有のフィールドにアノテーションを付けるために使用されます。Hotel 構造化データには次のプロパティがあります。

• name プロパティと address プロパティ

• makesOffer プロパティ

• Hotel priceSpecification プロパティ

• hasMerchantReturnPolicy プロパティ

• eligibleCustomerType プロパティ

HotelRoom 構造化データは、ウェブページの部屋固有のフィールドにアノテーションを付けるために使用されます。

キーポイント: 可能であれば、宿泊料金を指定することをおすすめします。

HotelRoom 構造化データには次のプロパティがあります。

• offers プロパティ

• bed プロパティと occupancy プロパティ

• HotelRoom priceSpecification プロパティ

• 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 プロパティの構文は次のとおりです。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">hotel-name</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">1234 Main St.</span>,
    <span itemprop="addressLocality">City Name</span>,
    <span itemprop="addressRegion">State Name</span>
    <span itemprop="postalCode">01234</span>
    <span itemprop="addressCountry">XX</span>
  </div>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
  </div>
</div>

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"]
    ...
  }
}

キーポイント: address プロパティを指定する場合は、addressCountry、postalCode、streetAddress などの PostalAddress 型とその他のフィールドが必須になります。

プロパティ

name プロパティと address プロパティは次のとおりです。

プロパティ	必須かどうか	種類	説明
Hotel.name	Required	string	ホテルの名前
Hotel.identifier	Required	string	パートナーのホテル ID。 識別子はホテルごとに一意の文字列である必要があり、料金フィードで使用される文字列と完全に一致する必要があります。
Hotel.address	Optional	PostalAddress	ホテルの住所または所在地。

名前と住所の例

以下は、name アノテーションと address アノテーションを追加する基本的な例です。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <h1 itemprop="name">Mountain Hotel</h1>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">Technikerstrasse 21</span>,
    <span itemprop="addressLocality">Innsbruck</span>,
    <span itemprop="addressRegion">Tyrol</span>
    <span itemprop="postalCode">6020</span>
    <span itemprop="addressCountry">AT</span>
  </div>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 プロパティの構文は次のとおりです。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">hotel-name</span>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="YYYY-MM-DDTHH:mm:ss">YYYY-MM-DD[THH:mm:ss]</time>
    Check-out: <time itemprop="checkoutTime" content="YYYY-MM-DDTHH:mm:ss">YYYY-MM-DD[THH:mm:ss]</time>
    <meta itemprop="availability" content="https://schema.org/InStock"/>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      ...
    </div>
  </div>
</div>

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 プロパティには、複数のホテルレベルの特典を含めることができます。Google に表示される料金を最初に記載する必要があります。指定された価格には、適用されるすべての税金と手数料が含まれます。

プロパティ

makesOffer のプロパティは次のとおりです。

プロパティ	必須かどうか	種類	説明
makesOffer	Required	Offer and LodgingReservation	指定した旅行プランのホテルの特典。 makesOffer プロパティには、オファーの配列を指定できます。
LodgingReservation.checkinTime	Required	DateTime	ユーザーのタイムゾーンでのチェックイン時間。タイムゾーンが記載されていない場合は、ホテルのタイムゾーンが考慮されます。
LodgingReservation.checkoutTime	Required	DateTime	ユーザーのタイムゾーンでのチェックアウト時間。タイムゾーンが記載されていない場合は、ホテルのタイムゾーンが考慮されます。

キーポイント: すべての特典の @type 値は、Offer と LodgingReservation の両方を含む配列にする必要があります。

makesOffer の例

ホテル特典にアノテーションを付ける基本的な例を次に示します。旅程に複数の料金を指定できますが、Google に表示される料金を最初に指定し、その後に他の料金を指定する必要があります。指定された価格には、適用されるすべての税金が含まれます。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">Mountain Hotel</span>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>
  </div>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1200.74</span>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 プロパティとバンドルされています。

重要ポイント: potentialAction プロパティは、ユーザーがチェックイン時にホテルで未払い額やその他の料金を支払う必要がある場合に使用されます。

  {
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": "float",
          "priceCurrency": "currency"
        },
        ...
      ]
    }
  }

構文

Hotel priceSpecification プロパティの構文は次のとおりです。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">hotel-name</span>
  ...
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name"></span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
        <meta itemprop="priceComponentType" content="GenericTax"/>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Discount</span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
        <meta itemprop="priceComponentType" content="Discount"/>
      </div>
    </div>
  </div>
</div>

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"
        }
      ]
    }
  }
}

プロパティ

hotel priceSpecification のプロパティは次のとおりです。

プロパティ	必須かどうか	種類	説明
Hotel.Offer.priceSpecification.price	Required	float	ホテルの合計料金（税金と諸費用を含む）。 Google の料金は、ランディング ページに常に完全な料金の詳細とともに注釈を付ける必要があります。料金の詳細に注釈を付けると、料金の精度チェックを完了できます。Google は、ホテル単位と部屋単位の両方の料金を受け付けます。
Hotel.Offer.priceSpecification.priceCurrency	Required	currency	指定された価格の 3 文字の通貨コード。例: "USD" 。
Hotel.Offer.priceSpecification.priceComponent	Optional	UnitPriceSpecification[]	ホテルの税金と諸費用を含む合計料金の内訳。 価格の構造化データには次の 2 種類があります。 CompoundPriceSpecification は、次のような価格の内訳を提供します。 基本料金: 1 泊あたりの基本料金 宿泊ごとの税金: 税金込みの 1 泊あたりの料金。 1 人あたりの料金: 1 泊あたりの料金。 Discount: 割引額。 UnitPriceSpecification は、料金のタイプを指定するために使用されます。追加料金を指定する PriceComponentTypeEnumeration 値を含める必要があります。 PriceComponentTypeEnumeration の値は次のとおりです。 Discount: 価格に対する一般的な割引。 ResortFee: ホテルで支払う必要がある追加料金です。宿泊施設のタイプによって異なります。 GenericTax: その他の税金です。 ServiceFee: 予約チャネルによって請求される追加料金です。 TransferFee: ホテルへの交通手段に対する事実上の必須料金で、ホテルまたは予約チャネルのいずれかによって徴収されます。 priceComponentType プロパティに値を設定する必要があります。UnitPriceSpecification を含める場合は、すべての値が必要であり、UnitPriceSpecification プロパティで指定する必要があります。
Hotel.Offer.priceSpecification.priceComponent. potentialAction	Optional	PayAction	ホテルの支払いポイント。ホテルの支払いフローには、予約サイトでのチェックアウト時と、ホテルでのチェックイン時に請求される料金が含まれます。 PayAction の「recipient」フィールドにバンドルされている potentialAction プロパティを使用して、支払いポイントを示す必要があります。recipient プロパティの詳細については、PayAction をご覧ください。 Google は、PayAction の受信者に対して次の 2 つの設定をサポートしています。 recipient.@type = "OnlineBusiness" は、オンライン販売者が予約時に徴収する支払いを指します。potentialAction が指定されていない場合、これがデフォルトの設定です。 recipient.@type = "Hotel" は、ホテルで徴収される料金を指します。

例

以下は、ホテルの料金仕様の例です。

価格

以下は、ウェブページに価格の構造化データを追加する基本的な例です。makesOffer プロパティには、複数のホテルレベルの特典を含めることができます。

address プロパティを指定する場合は、addressCountry、postalCode、streetAddress などの PostalAddress 型と他のフィールドが必須になります。Google に表示される料金は、makesOffer プロパティの最初に記載する必要があります。指定された価格には、適用されるすべての税金が含まれます。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">Technikerstrasse 21</span>,
    <span itemprop="addressLocality">Innsbruck</span>,
    <span itemprop="addressRegion">Tyrol</span>
    <span itemprop="postalCode">6020</span>
    <span itemprop="addressCountry">AT</span>
  </div>

  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>
  </div>

  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1200.74</span>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 プロパティで指定する必要があります。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <h1 itemprop="name">ACME Hotel</h1>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">123 Main street</span>,
    <span itemprop="addressLocality">Mountain View</span>,
    <span itemprop="addressRegion">Santa Clara</span>
    <span itemprop="postalCode">94040</span>
    <span itemprop="addressCountry">US</span>
  </div>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Total Price: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>

      <!-- Price Components -->
      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Base Rate</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1150</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">172.74</span>
        <meta itemprop="priceComponentType" content="GenericTax" />
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Discount</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">-100</span>
        <meta itemprop="priceComponentType" content="Discount" />
      </div>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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"
        }
      ]
    }
  }
}

お支払いポイント

以下は、PayAction の受信者タイプを使用する potentialAction 仕様の例です。

パッケージの合計料金は 1,170 ドルで、オンライン ウェブサイトでは "@type": "OnlineBusiness" を使用して指定された予約時に合計料金の一部である 1,150 ドルが請求され、ユーザーは @type": "Hotel" を使用して指定されたホテルのチェックイン時に残りの 20 ドルを支払う必要があります。

予約時とホテルでの支払いを分割するには、potentialAction コンポーネントを指定する必要があります。指定されていない場合、payAction は予約時の支払いをデフォルトのお支払い方法として解釈します。

重要ポイント: 予約時とホテルでの支払いの両方について、potentialAction を個別に定義する必要があります。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Price Due: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1170</span>

      <!-- Paid Online -->
      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1150</span>
        <div itemprop="potentialAction" itemscope itemtype="https://schema.org/PayAction">
          <div itemprop="recipient" itemscope itemtype="https://schema.org/OnlineBusiness">
            <span itemprop="name">myonlinebusiness</span>
          </div>
        </div>
      </div>

      <!-- Paid at Hotel -->
      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">20</span>
        <div itemprop="potentialAction" itemscope itemtype="https://schema.org/PayAction">
          <div itemprop="recipient" itemscope itemtype="https://schema.org/Hotel">
            <span itemprop="name">The Langham, Boston</span>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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": { ... }
            }
          }
        }
      ]
    }
  }
}

hasMerchantReturnPolicy 件の宿泊施設

このプロパティは、旅程で販売者の払い戻しポリシーにアノテーションを付けるために使用されます。

    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "refundType": "https://schema.org/FullRefund",
      "merchantReturnDays": "YYYY-MM-DD[THH:mm:ss]",
      "restockingFee": 0
    }

構文

hasMerchantReturnPolicy の構文は次のとおりです。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  ...
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <div itemprop="hasMerchantReturnPolicy" itemscope itemtype="https://schema.org/MerchantReturnPolicy">
      <link itemprop="returnPolicyCategory" href="https://schema.org/MerchantReturnFiniteReturnWindow"/>
      <link itemprop="refundType" href="https://schema.org/FullRefund"/>
      <meta itemprop="merchantReturnDays" content="YYYY-MM-DDTHH:mm:ss"/>
      <meta itemprop="restockingFee" content="0"/>
    </div>
  </div>
</div>

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	販売者の払い戻しポリシー。パートナーは、MerchantReturnPolicy.restockingFee を使用して、滞在日数の全額を払い戻さないキャンセル ポリシーを示す必要があります。 hasMerchantReturnPolicy が指定されていないか空のままの場合、金額は払い戻し不可とみなされます。払い戻し不可のポリシーは、returnPolicyCategory: MerchantReturnNotPermitted プロパティを使用して指定できます。

返品に関するポリシーの例

次に、客室の詳細と税金と手数料を含む合計料金が記載されたホテルの構造化データの基本的な例を示します。この例では、2023 年 12 月 18 日午後 11 時（UTC）まで無料でキャンセルできる宿泊を意味します。パートナーは、宿泊料金の全額を払い戻さないキャンセル ポリシーを示すために "MerchantReturnPolicy.restockingFee" を使用する必要があります。restockingFee のデフォルトは $0 です。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <div itemprop="hasMerchantReturnPolicy" itemscope itemtype="https://schema.org/MerchantReturnPolicy">
      <link itemprop="returnPolicyCategory" href="https://schema.org/MerchantReturnFiniteReturnWindow"/>
      <link itemprop="refundType" href="https://schema.org/FullRefund"/>
      Cancellation Deadline: <time itemprop="merchantReturnDays" content="2023-12-18T23:00:00">2023-12-18 23:00:00</time>
      Fee: $<span itemprop="restockingFee">0</span>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 プロパティの構文は次のとおりです。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  ...
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <meta itemprop="eligibleCustomerType" content="RewardsMember"/>
    ...
  </div>
</div>

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 プロパティを設定することで指定できます。

例

以下に、リワード メンバー料金の例を示します。

メンバー料金

以下は、ポイント プログラムのメンバー価格または制限付き料金の指定の基本的な例です。お客様はホテルの「ポイント プログラムのメンバー」です。

重要なポイント: name プロパティと eligibleCustomerType プロパティは Offer プロパティで指定する必要があります。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <!-- Address details -->
  </div>

  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <span itemprop="name">RewardsMember</span>
    <meta itemprop="eligibleCustomerType" content="RewardsMember"/>

    Check-in: <time itemprop="checkinTime" content="2023-12-15T16:00:00">Dec 15, 2023 4:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-12-20T11:00:00">Dec 20, 2023 11:00 AM</time>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Total: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1342.74</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Base rate</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1069.98</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">172.74</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">ResortFee</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">100</span>
      </div>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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"
        }
      ]
    }
  }
}

メンバー料金と通常料金

これは、通常料金とメンバー料金の両方の価格アノテーションの例です。メンバー価格が最初に表示され、その後に通常料金が表示されます。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <!-- Address details -->
  </div>

  <!-- Member Rate -->
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <span itemprop="name">RewardsMember</span>
    <meta itemprop="eligibleCustomerType" content="RewardsMember"/>

    Check-in: <time itemprop="checkinTime" content="2023-12-15T16:00:00">Dec 15, 2023 4:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-12-20T11:00:00">Dec 20, 2023 11:00 AM</time>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Total: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1342.74</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Base rate</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1069.98</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>: <span itemprop="priceCurrency" content="currency">$</span><span itemprop="price">172.74</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">ResortFee</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">100</span>
      </div>
    </div>
  </div>

  <!-- Regular Rate -->
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <span itemprop="name">regularRate</span>

    Check-in: <time itemprop="checkinTime" content="2023-12-15T16:00:00">Dec 15, 2023 4:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-12-20T11:00:00">Dec 20, 2023 11:00 AM</time>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Total: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1572.24</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Base rate</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1369.98</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>: <span itemprop="priceCurrency" content="currency">$</span><span itemprop="price">202.26</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">ResortFee</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">100</span>
      </div>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 の構造化データ

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 プロパティの構文は次のとおりです。

microdata

<div itemscope itemtype="https://schema.org/HotelRoom">
  <meta itemprop="identifier" content="hotel-room-id-1234"/>
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="YYYY-MM-DDTHH:mm:ss">YYYY-MM-DD[THH:mm:ss]</time>
    Check-out: <time itemprop="checkoutTime" content="YYYY-MM-DDTHH:mm:ss">YYYY-MM-DD[THH:mm:ss]</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
      ...
    </div>
  </div>
</div>

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	指定された旅行プランの客室料金の仕様。 offers プロパティには、オファーの配列を指定できます。
LodgingReservation.checkinTime	Required	DateTime	ユーザーのタイムゾーンでのチェックイン時間。タイムゾーンが記載されていない場合は、ホテルのタイムゾーンが考慮されます。
LodgingReservation.checkoutTime	Required	DateTime	ユーザーのタイムゾーンでのチェックアウト時間。タイムゾーンが記載されていない場合は、ホテルのタイムゾーンが考慮されます。

キーポイント: LodgingReservation のチェックインとチェックアウトの時間は、すべての宿泊プランの追加の @type プロパティで指定する必要があります。

offers の例

microdata

<div itemscope itemtype="https://schema.org/HotelRoom">
  <meta itemprop="identifier" content="hotel-room-id-1234"/>
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 プロパティの構文は次のとおりです。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">hotel-name</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="containsPlace" itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
    <span itemprop="name">room-name</span>
    <meta itemprop="identifier" content="hotel-room-id-1234"/>

    <!-- Bed Details -->
    <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
      <span itemprop="numberOfBeds">integer</span>
      <span itemprop="typeOfBed">KING</span>
    </div>

    <!-- Occupancy -->
    <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
      Occupancy: <span itemprop="value">integer</span>
    </div>

    <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
      ...
    </div>
  </div>
</div>

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	宿泊施設に含まれるベッドの種類と、部屋の宿泊人数。 サポートされている値は次のとおりです。 CALIFORNIA_KING KING QUEEN FULL DOUBLE SEMI_DOUBLE SINGLE
HotelRoom.occupancy	Optional (Recommended)	QuantitativeValue	ホテルの客室の宿泊人数。占有率の型は QuantitativeValue です。 占有率は、特定の Offer ではなく、HotelRoom の明示的なプロパティです。料金は、リクエストされた宿泊人数に対してのみタグ付けする必要があります。
containsPlace	Optional (Recommended)	LocationFeatureSpecification	特定の客室に関連付けられた客室レベルの料金にアノテーションを付けるために使用されます。客室の設備を指定するためにも使用できます。 amenityFeature プロパティで containsPlace を使用する方法について詳しくは、こちらをご覧ください。

例

以下は、ベッドと宿泊人数の仕様の例です。

HotelRoom の例

以下は、客室仕様のベッドと定員の基本的な例です。

microdata

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  <meta itemprop="identifier" content="hotel-room-id-1234"/>
  <span itemprop="name">Deluxe Room, 1 King Bed</span>

  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">KING</span>
  </div>
  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">SINGLE</span>
  </div>

  <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
    Occupancy: <span itemprop="value">2</span>
  </div>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 の例

以下は、bed、occupancy、priceSpecification とともに Hotel プロパティと HotelRoom プロパティにアノテーションを付ける例です。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">hotel-name</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>

  <div itemprop="containsPlace" itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
    <span itemprop="name">Deluxe Room, 1 King Bed</span>
    <meta itemprop="identifier" content="hotel-room-id"/>

    <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
      <span itemprop="numberOfBeds">1</span>
      <span itemprop="typeOfBed">KING</span>
    </div>

    <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
      Occupancy: <span itemprop="value">2</span>
    </div>

    <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
      <span itemprop="name">Minibar</span>
      <meta itemprop="value" content="true"/>
    </div>

    <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
      <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
      Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
      Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
      <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
      </div>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 件の宿泊施設

ホテルの客室料金の指定は、ホテルの料金の指定と似ています。異なる点は、客室料金は Hotel.makesOffer プロパティではなく Product.offers プロパティを使用して指定する点です。

"priceSpecification": {
  "@type": "CompoundPriceSpecification",
  "price": "float",
  "priceCurrency": "currency",
  "priceComponent": {
    "@type": "UnitPriceSpecification",
    "name": "GenericTax",
    "price": "float",
    "priceCurrency": "currency"
  }
  ...
}

構文

ホテル客室の priceSpecification プロパティの構文は次のとおりです。

microdata

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  ...
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name"></span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
        <meta itemprop="priceComponentType" content="GenericTax"/>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Discount</span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
        <meta itemprop="priceComponentType" content="Discount"/>
      </div>
    </div>
  </div>
</div>

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	Product の税金と手数料を含む、1 部屋あたりの料金。 Google の料金は、ランディング ページに常に完全な料金の詳細とともに注釈を付ける必要があります。料金の詳細に注釈を付けると、料金の精度チェックを完了できます。Google は、ホテル単位と部屋単位の両方の料金を受け付けます。
Hotel.Offer.priceSpecification.priceCurrency	Required	currency	指定された価格の 3 文字の通貨コード。例: "USD" 。
Hotel.Offer.priceSpecification.priceComponent	Optional	UnitPriceSpecification[]	ホテル客室の合計料金の内訳（税金と手数料を含む）。HotelRoom と Product にリンクされた特典を含む宿泊人数。価格の構造化データには次の 2 種類があります。 CompoundPriceSpecification は、次のような価格の内訳を提供します。 基本料金: 1 泊あたりの基本料金 宿泊ごとの税金: 税金込みの 1 泊あたりの料金。 1 人あたりの料金: 1 泊あたりの料金。 occupancy は、特定の Offer ではなく、HotelRoom の明示的なプロパティです。料金は、リクエストされた宿泊人数に対してのみタグ付けする必要があります。 Discount: 割引額。 UnitPriceSpecification は、料金のタイプを指定するために使用されます。追加料金を指定する PriceComponentTypeEnumeration 値を含める必要があります。 PriceComponentTypeEnumeration の値は次のとおりです。 Discount: 価格に対する一般的な割引。 ResortFee: ホテルで支払う必要がある追加料金です。宿泊施設のタイプによって異なります。 GenericTax: その他の追加税です。 ServiceFee: 予約チャネルによって請求される追加料金です。 UnitPriceSpecification の name プロパティに値を設定する必要があります。価格の内訳を含める場合は、すべての値が必須となり、UnitPriceSpecification コンポーネントで指定する必要があります。

例

以下に HotelRoom 価格仕様の例を示します。

合計宿泊料金の例

次の例は、宿泊日数と定員あたりの料金の合計金額を定義する基本的な例です。

microdata

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  <span itemprop="name">Deluxe Room King, 1 Single Bed</span>
  <meta itemprop="identifier" content="hotel-room-id-1234"/>

  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">KING</span>
  </div>
  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">SINGLE</span>
  </div>

  <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
    Occupancy: <span itemprop="value">2</span>
  </div>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1232.74</span>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 客室などの客室タイプ、KING ベッドや SINGLE ベッドなどの bed タイプと occupancy タイプ、2 名の宿泊客の定員数に対して定義されます。

microdata

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  <span itemprop="name">Deluxe Room King, 1 Single Bed</span>
  <meta itemprop="identifier" content="hotel-room-id-1234"/>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>

    <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
      <span itemprop="numberOfBeds">1</span>
      <span itemprop="typeOfBed">KING</span>
    </div>
    <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
      <span itemprop="numberOfBeds">1</span>
      <span itemprop="typeOfBed">SINGLE</span>
    </div>

    <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
      Occupancy: <span itemprop="value">2</span>
    </div>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Total: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Base rate</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1150</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">172.74</span>
        <meta itemprop="priceComponentType" content="GenericTax"/>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Discount</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">-100</span>
        <meta itemprop="priceComponentType" content="Discount"/>
      </div>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 件の宿泊施設

このプロパティは、食事オプションやバレーパーキングなどのホテルや客室で提供される料金固有のサービスをアノテーションするために使用されます。includesObject は Hotel プロパティまたは HotelRoom プロパティのいずれかでアノテーションを付けることができます。

{
  "includesObject": [
    {
      "@type": "TypeAndQuantityNode",
      "typeOfGood": {
        "@type": "Service",
        "name": "Valet"
      }
    },
    {
      "@type": "TypeAndQuantityNode",
      "amountOfThisGood": "float",
      "unitText": "currency",
      "typeOfGood": {
        "@type": "FoodService",
        "name": "MealCredit"
      }
    }
  ]
}

構文

includesObject には、部屋で利用可能な料金固有のサービスに関する次の構文があります。

microdata

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  ...
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <div itemprop="includesObject" itemscope itemtype="https://schema.org/TypeAndQuantityNode">
      <div itemprop="typeOfGood" itemscope itemtype="https://schema.org/Service">
        <span itemprop="name">Valet</span>
      </div>
    </div>

    <div itemprop="includesObject" itemscope itemtype="https://schema.org/TypeAndQuantityNode">
      <meta itemprop="amountOfThisGood" content="float"/>
      <meta itemprop="unitText" content="currency"/>
      <div itemprop="typeOfGood" itemscope itemtype="https://schema.org/FoodService">
        <span itemprop="name">MealCredit</span>
      </div>
    </div>
  </div>
</div>

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	ホテルまたは客室で提供されるサービス。 レート固有の機能は includesObject プロパティに含まれています。"TypeAndQuantityNode.typeOfGood" の name フィールドは、バレーサービスや食事サービスなどのサービスの種類を示すために使用する必要があります。 レート固有の機能は、基本レベルの特典に含まれる場合もあれば、追加料金でアドオンとして指定される場合もあります。 includesObject には、次のように TypeAndQuantityNode 型の値を指定する必要があります。 BreakfastIncluded DinnerIncluded Valet MealCredit

includesObject の例

以下に、バレーパーキングとフード サービスに関する料金固有の特典の基本的な例を示します。料金固有の機能は、Offer.includesObject プロパティで指定する必要があります。TypeAndQuantityNode.typeOfGood の name フィールドを使用して、サービスの種類を示す必要があります。

microdata

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  <span itemprop="name">Deluxe Room, 1 King Bed</span>
  <meta itemprop="identifier" content="hotel-room-id-1234"/>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>

    <!-- Included Services -->
    <div itemprop="includesObject" itemscope itemtype="https://schema.org/TypeAndQuantityNode">
      <div itemprop="typeOfGood" itemscope itemtype="https://schema.org/Service">
        <span itemprop="name">Valet</span>
      </div>
    </div>

    <div itemprop="includesObject" itemscope itemtype="https://schema.org/TypeAndQuantityNode">
      <meta itemprop="amountOfThisGood" content="50"/>
      <meta itemprop="unitText" content="USD"/>
      <div itemprop="typeOfGood" itemscope itemtype="https://schema.org/FoodService">
        <span itemprop="name">MealCredit</span>
      </div>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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 プロパティの構文は次のとおりです。

microdata

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  ...
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <meta itemprop="availability" content="https://schema.org/SoldOut"/>
    Sold Out
  </div>
</div>

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	ホテルまたは客室の空室状況。 レートは schema.org/Offer から抽出され、レート情報は schema.org/Hotel または schema.org/HotelRoom を使用して作成されません。つまり、完売した旅行プランにも特典が必要です。 priceSpecification のない特典は利用不可とみなされます。利用できない特典は "Offer.availability= https://schema.org/SoldOut" として指定する必要があります。 有効な priceSpecification. でオファーにアノテーションが付けられている場合、Offer.availability を指定する必要はありません。

availability の例

次の例は、ホテルの客室の空室状況を示す基本的な例です。指定された客室のベッドの種類、ベッド数、宿泊人数に関する詳細を含める必要があります。

microdata

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  <span itemprop="name">Deluxe Room, 1 King Bed</span>
  <meta itemprop="identifier" content="hotel-room-id-1234"/>

  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">KING</span>
  </div>
  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">SINGLE</span>
  </div>

  <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
    Occupancy: <span itemprop="value">2</span>
  </div>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <meta itemprop="availability" content="https://schema.org/SoldOut"/>
    Sold Out

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <!-- Price Specification details -->
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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": {...}
  }
}

重要なポイント: 売り切れの旅程には Offers を指定する必要があります。

amenityFeature 件の宿泊施設

amenityFeature プロパティを使用して、Hotel タイプまたは HotelRoom タイプのいずれかでアメニティを指定できます。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 プロパティの構文は次のとおりです。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  ...
  <!-- Hotel Amenity -->
  <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
    <span itemprop="name">HotTub</span>
    <div itemprop="hoursAvailable" itemscope itemtype="https://schema.org/OpeningHoursSpecification">
      <time itemprop="opens" content="HH:mm:ss">HH:mm:ss</time>
      <time itemprop="closes" content="HH:mm:ss">HH:mm:ss</time>
    </div>
  </div>

  <div itemprop="containsPlace" itemscope itemtype="https://schema.org/HotelRoom">
    <!-- Room Amenity -->
    <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
      <span itemprop="name">Minibar</span>
      <meta itemprop="value" content="boolean"/>
    </div>
  </div>
</div>

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	宿泊施設で利用できるインターネットの種類。 サポートされている値は次のとおりです。 FREE PAID NONE
amenityFeature.ParkingType	Optional	Enum	宿泊施設で利用できる駐車場の種類。 サポートされている値は次のとおりです。 FREE PAID NONE
amenityFeature.PoolType	Optional	Enum	宿泊施設で利用できるプールの種類。 サポートされている値は次のとおりです。 INDOOR OUTDOOR NONE
amenityFeature.RoomStyle	Optional	Enum	部屋が和風のデザインかどうかを示します。 サポートされている値は次のとおりです。 WESTERN JAPANESE JAPANESE_WESTERN
amenityFeature.LicenseNum	Required	string	世界の特定の地域では、宿泊施設に表示するビジネスのライセンス番号が必要です。これは反復する可能性があるため、複数のライセンスを所持している場合は、ライセンスの所有者または認証機関を追加することをおすすめします。例: "Paris: 123456ABC"

プロパティ

amenityFeature のプロパティは次のとおりです。

プロパティ	必須かどうか	種類	説明
amenityFeature	Optional	LocationFeatureSpecification	ホテルまたは客室で提供されるアメニティ。これは amenityFeature プロパティを使用して指定できます。アメニティは、選択した料金プランに関係なく、ホテルのすべての宿泊客が利用できる必要があります。amenityFeature は LocationFeatureSpecification プロパティ値を使用して指定します。 アメニティは Hotel レベルまたは HotelRoom レベルで指定できます。
containsPlace	Optional	LocationFeatureSpecification	すべての宿泊客に提供されるホテルまたは客室内のアメニティ。これは、amenityFeature を使用して指定できます。設備は、選択した料金プランに関係なく、ホテルの客室のすべての宿泊客が利用できる必要があります。 Hotel.containsPlace.amenityFeature は、ホテルで提供される設備です。 HotelRoom.containsPlace.amenityFeature は、客室に備え付けられているアメニティです。

アメニティの例

以下は、プールが午前 10 時から午後 10 時まで利用可能で、ジムがないホテルの基本的な例です。ホテルの客室は禁煙で、ミニバーがあります。

microdata

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>

  <!-- Amenities -->
  <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
    <span itemprop="name">HotTub</span>
    <div itemprop="hoursAvailable" itemscope itemtype="https://schema.org/OpeningHoursSpecification">
      Open from <time itemprop="opens" content="10:00:00">10:00</time>
      to <time itemprop="closes" content="22:00:00">22:00</time>
    </div>
  </div>

  <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
    <span itemprop="name">GymFitnessEquipment</span>:
    <meta itemprop="value" content="false"/> No
  </div>

  <div itemprop="containsPlace" itemscope itemtype="https://schema.org/HotelRoom">
    <!-- Room Amenities -->
    <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
      <span itemprop="name">Minibar</span>:
      <meta itemprop="value" content="true"/> Yes
    </div>
    <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
      <span itemprop="name">Smoking</span>:
      <meta itemprop="value" content="false"/> No
    </div>

    <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
      <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
      Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
      Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
      <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
      </div>
    </div>
  </div>
</div>

JSON-LD（非推奨）

{
  "@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"
      }
    }
  }
}

ナビゲーション タグ

data-nav- プレフィックスが付いたカスタム HTML5 属性は、インタラクティブな要素にアノテーションを付け、ページの状態を宣言するために使用されます。これにより、クローラーは予約フローをナビゲートできます。

構文

ナビゲーション タグには次の属性構文が使用されます。

属性

<body data-nav-stage="stage_name">
  ...
  <button data-nav-criticalpath="true"
          data-nav-interactiontype="CLICK"
          data-nav-interactionorder="1">
    Action
  </button>
  ...
  <button data-nav-close="true">Dismiss</button>
</body>

プロパティ

ナビゲーション属性は次のとおりです。

属性	値	説明
data-nav-stage	landing, room-selection, checkout, confirmation	クローラーのアクティブなファネル状態を宣言します。<body> または上位ラッパーにアタッチされます。
data-nav-stage-final	true, false	フローの最終ページのインジケーター（デフォルトは false）。ページに data-nav-criticalpath="true" の要素がない場合、クローラーは自動的にそのページをフローの最終ページと見なします。
data-nav-criticalpath	true, false	最終的な予約ページに到達するためにクローラーが操作しなければならない要素をマークします。ページに data-nav-criticalpath="true" を含む要素がない場合、クローラーは自動的にそのページをフローの最終ページとみなします。
data-nav-interactiontype	CLICK, SELECT	インタラクションのアクションを指定します。CLICK はボタン/リンク用です。SELECT はプルダウン/ラジオ グループ用です。
data-nav-interactionorder	integer	複数ステップのナビゲーションの実行順序を提供します。数値が小さいほど先に実行されます。
data-nav-close	true	ポップアップ、Cookie バナーのオーバーレイ、アップセル モーダルの閉じるボタンをマークします。

ナビゲーションの例

ナビゲーション タグ付けの例を次に示します。

ナビゲーションのクリック

次の例は、ファネル ステージを宣言するクリック ナビゲーションの基本的な例です。

<body data-nav-stage="room-selection" data-nav-stage-final="false">
  <h1>Select Your Room</h1>
  
  <!-- Crawler needs to click this to proceed -->
  <button data-nav-criticalpath="true"
          data-nav-interactiontype="CLICK"
          data-nav-interactionorder="1">
    Select & Proceed
  </button>
</body>

マルチステップ ナビゲーション

次の例は、Cookie バナー、アコーディオンの展開、クリックを含む複数ステップのナビゲーションの例です。

<div data-nav-stage="landing" data-nav-stage-final="false">
  <!-- Hotel, LodgingReservation info, and Offer price are expected to be included in this page -->

  <!-- Step 1: Accept cookies -->
  <div class="cookie-banner">
    <p>We use cookies to improve your experience.</p>
    <button data-nav-close="true"
            data-nav-criticalpath="true"
            data-nav-interactiontype="CLICK"
            data-nav-interactionorder="1">Accept cookies</button>
  </div>

  <!-- Step 2: Open accordion to reveal pricing (Crucial for making prices visible in Mobile UIs) -->
  <div data-nav-criticalpath="true"
       data-nav-interactiontype="CLICK"
       data-nav-interactionorder="2"
       class="accordion-header">
    <span>View Room Rates</span>
  </div>


  <!-- Step 3: Book the room -->
  <div class="accordion-content">
    <button data-nav-criticalpath="true"
            data-nav-interactiontype="CLICK"
            data-nav-interactionorder="3">
      Book Now
    </button>
  </div>
</div>

最終ページの宣言

以下は、予約フローの最終ページを宣言する例です。

<!-- Marks this as the final confirmation page where price is extracted -->
<!-- Hotel, LodgingReservation info, and Offer price are expected to be included in this page -->
<div data-nav-stage="confirmation" data-nav-stage-final="true">
  <h1>Grand View Hotel</h1>
  <!-- Price and other details here -->
</div>