구조화된 호텔 가격 데이터 참조

이 페이지에서는 Schema.org 호텔 구조화된 데이터 마크업의 기술 사양 및 어휘 참조를 제공합니다.

개요

구조화된 호텔 가격 데이터는 시각적 레이아웃과 관계없이 웹사이트에 표시된 호텔 가격을 설명, 검증, 표시하는 표준화된 기계 판독 가능 형식을 제공합니다. 여기에는 기본 가격, 요금, 객실 사양, 항목별 수수료 및 세금, 예약 정책이 포함됩니다.

Google에서는 웹페이지에서 가격을 정확하게 추출할 수 있도록 Schema.org에서 제공하는 표준화된 구조화된 데이터를 사용하여 웹페이지에 주석을 추가할 것을 권장합니다.

표준 구조화된 데이터를 사용하면 크롤러의 신뢰성을 개선하고, 가격 정확도 검사 횟수를 늘리고, 가격 정확도 문제를 직접 디버깅하고, 일관된 가격 정확도 점수를 유지하여 가격 정확도 검사를 확장할 수 있습니다.

구조화된 데이터를 처음 사용한다면 구조화된 데이터 어휘 및 형식을 자세히 알아보세요.

Google 호텔에서는 호텔 가격 정확도 검사를 위해 웹페이지에 주석을 달 때 기본적으로 마이크로데이터 형식을 사용할 것을 권장합니다. 가격 정확도 검증을 위해 JSON-LD 형식이 지원 중단되었습니다. 이 권장사항은 호텔 가격 정확도 검사에만 적용되며 Google 전반의 구조화된 데이터의 다른 용도 (예: Google 검색 리치 결과)에는 영향을 미치지 않습니다. 일반 검색 기능에 지원되는 형식에 대해 자세히 알아보려면 지원되는 형식을 참고하세요. 이 문서에서는 호텔의 구조화된 데이터 구현과 관련된 자세한 참조 콘텐츠를 제공합니다.

Hotel 구조화된 데이터는 웹페이지에서 호텔 관련 필드에 주석을 추가하는 데 사용됩니다. Hotel 구조화된 데이터에는 다음과 같은 속성이 있습니다.

HotelRoom 구조화된 데이터는 웹페이지에서 객실별 필드에 주석을 추가하는 데 사용됩니다.

HotelRoom 구조화된 데이터에는 다음과 같은 속성이 있습니다.

탐색 속성은 크롤러에게 대화형 요소와 페이지 상태를 설명하는 데 사용됩니다. 자세한 내용은 탐색 태그 지정을 참고하세요.

호텔 구조화된 데이터

다음 속성은 호텔 항목에 적용됩니다.

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 속성은 다음 구문을 사용합니다.

마이크로데이터

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

속성

다음은 name 및 address 속성입니다.

속성 필수 여부 유형 설명
Hotel.name Required string 호텔 이름
Hotel.identifier Required string

파트너의 호텔 ID입니다.

식별자는 호텔당 고유한 문자열이어야 하며 가격 피드에 사용된 문자열과 정확히 일치해야 합니다.
Hotel.address Optional PostalAddress 호텔의 주소 또는 위치입니다.

이름 및 주소 예시

다음은 name 및 address 주석을 추가하는 기본적인 예시입니다.

마이크로데이터

<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 속성은 다음 구문을 사용합니다.

마이크로데이터

<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 속성입니다.

속성 필수 여부 유형 설명
makesOffer Required Offer and LodgingReservation

지정된 여행 일정의 호텔 혜택입니다.

makesOffer 속성에는 혜택 배열이 포함될 수 있습니다.
LodgingReservation.checkinTime Required DateTime

사용자 시간대의 체크인 시간입니다. 표준 시간대가 언급되지 않은 경우 호텔 표준 시간대가 고려됩니다.
LodgingReservation.checkoutTime Required DateTime

사용자 시간대의 체크아웃 시간입니다. 표준 시간대가 언급되지 않은 경우 호텔 표준 시간대가 고려됩니다.

makesOffer 예시

다음은 호텔 상품을 주석 처리하는 기본 예입니다. 여정에 여러 혜택을 지정할 수 있지만 Google에 표시되는 요금을 먼저 지정한 다음 다른 요금을 지정해야 합니다. 지정된 가격 금액에는 모든 관련 세금이 포함됩니다.

마이크로데이터

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

이 속성은 호텔 또는 호텔 객실의 가격 정보를 주석으로 처리하는 데 사용됩니다. 가격과 세금을 주석으로 달려면 두 가지 속성을 추가해야 합니다. 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 속성은 다음 구문을 사용합니다.

마이크로데이터

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

호텔의 세금 및 수수료를 포함한 총 가격 세부정보입니다. 가격 구조화 데이터에는 두 가지 유형이 있습니다.

  • CompoundPriceSpecification는 다음을 포함하는 가격 세부정보를 제공합니다.

    • 기본 요금: 1박당 기본 가격

    • 숙박당 세금: 세금이 포함된 1박당 가격입니다.

    • 숙박인당 요금: 숙박인당 1박당 가격입니다.

    • 할인: 공제 금액입니다.

  • 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의 수신자에 대해 다음 두 가지 설정을 지원합니다.

  • recipient.@type = "OnlineBusiness"는 온라인 판매자가 예약 시 징수한 결제를 나타냅니다. potentialAction이 지정되지 않은 경우 기본 설정입니다.

  • recipient.@type = "Hotel"는 호텔에서 징수된 결제를 나타냅니다.

예

다음은 호텔 가격 사양의 예입니다.

가격

다음은 웹페이지에 가격 구조화된 데이터를 추가하는 기본적인 예입니다. makesOffer 속성에는 여러 호텔 수준 혜택이 포함될 수 있습니다.

address 속성을 지정하는 경우 addressCountry, postalCode, streetAddress과 같은 PostalAddress 유형 및 기타 필드가 필수입니다. Google에 표시되는 요율은 makesOffer 속성에 가장 먼저 나열되어야 합니다. 지정된 가격 금액에는 모든 관련 세금이 포함됩니다.

마이크로데이터

<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 구성요소를 사용하여 정의됩니다. UnitPriceSpecification 구성요소에 해당하는 값으로 priceComponentType 필드를 설정해야 합니다.

숙박 기간의 총 가격은 CompoundPriceSpecification 속성에 지정해야 합니다. 가격 세부정보는 priceComponent 속성에 지정해야 합니다.

마이크로데이터

<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은 예약 시 결제를 기본 결제 수단으로 해석합니다.

마이크로데이터

<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의 구문은 다음과 같습니다.

마이크로데이터

<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입니다.

마이크로데이터

<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 속성에는 다음 구문이 있습니다.

마이크로데이터

<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 속성을 설정하여 지정할 수 있습니다.

예

다음은 리워드 회원 요금의 예입니다.

회원가

다음은 포인트 멤버십의 회원 가격 또는 제한된 요금 사양의 기본 예입니다. 고객이 호텔의 '포인트 멤버'입니다.

마이크로데이터

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

회원 요금 및 일반 요금

다음은 일반 요금과 회원 요금 가격 주석의 예입니다. 회원 가격이 먼저 표시되고 일반 요금이 표시됩니다.

마이크로데이터

<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 속성에는 다음 구문이 있습니다.

마이크로데이터

<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

사용자 시간대의 체크아웃 시간입니다. 표준 시간대가 언급되지 않은 경우 호텔 표준 시간대가 고려됩니다.

offers 예시

마이크로데이터

<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 속성은 객실의 투숙객 수를 주석으로 표시하는 데 사용됩니다. HotelRoom 속성을 사용하여 bed 및 occupancy 속성을 지정할 수 있습니다.

"@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 속성에는 다음 구문이 있습니다.

마이크로데이터

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

다음은 객실 사양의 침대 및 숙박 인원의 기본 예시입니다.

마이크로데이터

<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 속성에 주석을 다는 예입니다.

마이크로데이터

<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 속성에는 다음 구문이 있습니다.

마이크로데이터

<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의 세금 및 수수료를 포함한 객실당 가격입니다.

Google 요금은 항상 방문 페이지에 전체 요금 세부정보와 함께 주석으로 표시되어야 합니다. 요금 세부정보에 주석을 달면 가격 정확성 검사를 완료할 수 있습니다. Google에서는 호텔 수준 가격과 객실 수준 가격을 모두 허용합니다.
Hotel.Offer.priceSpecification.priceCurrency Required currency 지정된 가격의 3자리 통화 코드입니다. 예: "USD"
Hotel.Offer.priceSpecification.priceComponent Optional UnitPriceSpecification[]

HotelRoom 및 Product에 연결된 혜택이 적용된 호텔 객실 및 숙박 인원의 세금 및 수수료를 포함한 총 가격 세부정보입니다. 가격 구조화 데이터에는 두 가지 유형이 있습니다.

  • CompoundPriceSpecification는 다음을 포함하는 가격 세부정보를 제공합니다.

    • 기본 요금: 1박당 기본 가격

    • 숙박당 세금: 세금이 포함된 1박당 가격입니다.

    • 숙박인당 요금: 숙박인당 1박당 가격입니다.

      occupancy는 특정 Offer이 아닌 HotelRoom의 명시적 속성입니다. 요금은 요청된 숙박 인원에 대해서만 태그해야 합니다.

    • 할인: 공제 금액입니다.

  • UnitPriceSpecification는 요금 유형을 지정하는 데 사용됩니다. 추가 요금을 지정하는 PriceComponentTypeEnumeration 값을 포함해야 합니다.

    PriceComponentTypeEnumeration의 값은 다음과 같습니다.

    • Discount: 가격에 적용되는 일반적인 할인입니다.

    • ResortFee: 호텔에서 지불해야 하는 추가 요금입니다. 숙박 시설 유형에 따라 다를 수 있습니다.

    • GenericTax: 기타 추가 세금입니다.

    • ServiceFee: 예약 채널에서 청구하는 추가 수수료입니다.

    UnitPriceSpecification의 name 속성에서 값을 설정해야 합니다. 가격 세부정보를 포함하는 경우 모든 값이 필요하며 UnitPriceSpecification 구성요소에 지정해야 합니다.

예

다음은 HotelRoom 가격 사양의 예입니다.

총 객실 요금 예

다음은 투숙 기간의 총 가격과 점유당 가격을 정의하는 기본 예시입니다.

마이크로데이터

<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명에 대해 정의됩니다.

마이크로데이터

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

이 속성은 식사 옵션, 발레파킹 서비스 등 호텔 또는 객실에서 제공되는 요금별 서비스를 주석 처리하는 데 사용됩니다. Hotel 또는 HotelRoom 속성에서 includesObject에 주석을 달 수 있습니다.

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

구문

includesObject에는 방에서 사용할 수 있는 요금별 서비스에 관한 다음 구문이 있습니다.

마이크로데이터

<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"의 이름 필드는 발렛 또는 식사 서비스와 같은 서비스 유형을 나타내는 데 사용해야 합니다.

요금별 기능은 기본 수준 혜택에 포함될 수도 있고 추가 가격의 부가기능으로 지정될 수도 있습니다.

includesObject에는 다음과 같은 TypeAndQuantityNode 유형의 값이 필요합니다.

  • BreakfastIncluded
  • DinnerIncluded
  • Valet
  • MealCredit

includesObject 예시

다음은 발레파킹 및 음식 서비스의 요금별 기능에 대한 기본 예시입니다. 요금별 기능은 Offer.includesObject 속성으로 지정해야 합니다. TypeAndQuantityNode.typeOfGood의 이름 필드는 서비스 유형을 나타내는 데 사용해야 합니다.

마이크로데이터

<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 속성에는 다음 구문이 있습니다.

마이크로데이터

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

다음은 호텔 객실의 이용 불가능을 보여주는 기본 예시입니다. 지정된 객실의 침대 유형, 침대 수, 숙박 인원 세부정보를 포함해야 합니다.

마이크로데이터

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

숙박 시설 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 속성의 구문은 다음과 같습니다.

마이크로데이터

<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시까지 운영되는 수영장이 있고 숙박 시설에 헬스장이 없는 호텔의 기본 예입니다. 호텔 객실은 금연이며 미니바가 있습니다.

마이크로데이터

<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 팝업, 쿠키 배너 오버레이 또는 업셀 모달의 닫기 버튼을 표시합니다.

다음은 탐색 태그의 예입니다.

탐색 클릭

다음은 유입경로 단계를 선언하는 클릭 탐색의 기본 예시입니다.

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

다단계 탐색

다음은 쿠키 배너, 아코디언 공개, 클릭을 포함한 다단계 탐색의 예입니다.

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