مرجع داده های ساختاری قیمت هتل

این صفحه مرجعی برای افزودن نشانه گذاری های داده های ساختاریافته به داده های قیمت هتل های شما ارائه می دهد.

نمای کلی

داده‌های ساختاری قیمت هتل برای توضیح، تأیید و نمایش جزئیات قیمت‌های هتل در وب‌سایت شما بدون توجه به رابط کاربری استفاده می‌شود. این همچنین شامل قیمت پایه، نرخ‌ها، اتاق‌ها، هزینه‌ها و مالیات و زمینه‌های مربوط به قیمت‌گذاری می‌شود.

Google به شرکای خود توصیه می‌کند که صفحات وب خود را با داده‌های ساختاریافته استاندارد که برای خزنده‌ها قابل خواندن با ماشین هستند، حاشیه‌نویسی کنند. ارائه شده توسط schema.org ، برای حذف دقیق قیمت ها از صفحات وب شما.

این اجازه می دهد تا اعتبارسنجی دقت قیمت را از طریق بهبود قابلیت اطمینان خزنده ها مقیاس بندی کنید. مزیت شما افزایش تعداد اعتبارسنجی دقت قیمت و امکان اشکال زدایی مستقیم مسائل مربوط به دقت قیمت و همچنین داشتن امتیاز دقت قیمت ثابت است.

اگر با داده های ساختاریافته تازه کار هستید، درباره واژگان و قالب داده های ساختاریافته بیشتر بیاموزید.

Google Hotels فرمت JSON-LD را برای حاشیه نویسی صفحات وب شما توصیه می کند. برای کسب اطلاعات بیشتر در مورد سایر قالب های قابل قبول به فرمت های پشتیبانی شده مراجعه کنید. این مستندات محتوای مرجع دقیقی را برای اجرای داده های ساختاریافته در هتل ها ارائه می دهد.

داده های ساخت یافته 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 از دستور زیر استفاده می کند:

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

شناسه هتل شرکا

شناسه باید یک رشته منحصر به فرد در هر هتل باشد و باید دقیقاً با رشته مورد استفاده در فید قیمت مطابقت داشته باشد.

Hotel.address Optional PostalAddress آدرس یا مکان هتل.

نمونه ها

نام و آدرس

مثال زیر یک مثال اساسی از اضافه کردن حاشیه نویسی name و address است:

{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "Mountain Hotel",
"identifier": "hotel-id-1234",
"address": {
  "@type": "PostalAddress",
  "addressCountry": "AT",
  "addressLocality": "Innsbruck",
  "addressRegion": "Tyrol",
  "postalCode": "6020",
  "streetAddress": "Technikerstrasse 21"
},
"makesOffer": {
  "@type": ["Offer", "LodgingReservation"],
  "checkinTime": "2023-03-10 15:00:00",
  "checkoutTime": "2023-03-16 10:00:00",
  "priceSpecification": {
    "@type": "CompoundPriceSpecification",
    "price": 1222.74,
    "priceCurrency": "USD"
  }
}
}

دارایی makesOffer

حاشیه نویسی makesOffer برای نشانه گذاری برنامه های سفر هتل شما استفاده می شود.

  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/InStock",
    ...
  }

نحو

ویژگی makesOffer از نحو زیر استفاده می کند:

JSON-LD 

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "address": { ... },
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/InStock",
    "priceSpecification": { ... }
  }
}

خواص

ویژگی های makesOffer به شرح زیر است:

اموال مورد نیاز؟ تایپ کنید توضیحات
makesOffer Required Offer and LodgingReservation

پیشنهاد(های) هتل برای برنامه سفر داده شده.

ویژگی makesOffer می تواند شامل مجموعه ای از پیشنهادات باشد.

LodgingReservation.checkinTime Required DateTime

زمان ورود در منطقه زمانی کاربر. اگر منطقه زمانی شما ذکر نشده باشد، منطقه زمانی هتل در نظر گرفته می شود.

LodgingReservation.checkoutTime Required DateTime

زمان خروج در منطقه زمانی کاربر. اگر منطقه زمانی شما ذکر نشده باشد، منطقه زمانی هتل در نظر گرفته می شود.

مثال

پیشنهاد می کند

مثال زیر یک مثال اساسی برای حاشیه نویسی پیشنهادات هتل شما است. می توانید چندین پیشنهاد را برای یک برنامه سفر مشخص کنید، اما باید ابتدا نرخ نمایش داده شده توسط Google و سپس سایر نرخ ها را مشخص کنید. مبلغ قیمت مشخص شده شامل کلیه مالیات های قابل اجرا می باشد.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "Mountain Hotel",
  "identifier": "hotel-id-1234",
  "address": { ... },
  "makesOffer": [
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    },
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1200.74,
        "priceCurrency": "USD"
      }
    }
  ]
}

Hotel priceSpecification ملک

این ویژگی برای حاشیه نویسی اطلاعات قیمت هتل یا اتاق های هتل شما استفاده می شود. دو ملک اضافی وجود دارد که برای حاشیه نویسی قیمت و مالیات شما مورد نیاز است. شما باید از CompoundPriceSpecification برای تعیین کل اطلاعات قیمت گذاری مانند نرخ پایه، مالیات و تخفیف استفاده کنید. از UnitPriceSpecification برای تعیین مالیات های اضافی یا انواع ویژه هزینه ها مانند ResortFee ، GenericTax و ServiceFee استفاده کنید. ویژگی priceSpecification با ویژگی Offer همراه است.

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

نحو

ویژگی Hotel priceSpecification از نحو زیر استفاده می کند:

JSON-LD 

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": "float",
          "priceCurrency": "currency"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "GenericTax",
          "potentialAction": {
            "@type": "https://schema.org/PayAction",
            "recipient": {
              "@type": "OnlineBusiness",
              "name": "name-of-the-business"
            }
          }
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

میکروداده 

  <div itemscope itemtype="https://schema.org/Hotel">
    <meta itemprop="name" content="hotel-name"/>
    ...
    <div itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation" itemprop="makesOffer">
      ...
      <div itemscope itemtype="https://schema.org/CompoundPriceSpecification" itemprop="priceSpecification">
        <meta itemprop="price" content="float"/>
        <meta itemprop="priceCurrency" content="currency"/>
        <div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
          <meta itemprop="name" content=""/>
          <meta itemprop="price" content="float"/>
          <meta itemprop="priceCurrency" content="currency"/>
        </div>
        <div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
          <meta itemprop="name" content="GenericTax" />
          <meta itemprop="price" content="float"/>
          <meta itemprop="priceCurrency" content="currency"/>
          <meta itemprop="priceComponentType" content="GenericTax"/>
        </div>
        <div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
          <meta itemprop="name" content="Discount"/>
          <meta itemprop="price" content="float"/>
          <meta itemprop="priceCurrency" content="currency"/>
          <meta itemprop="priceComponentType" content="Discount"/>
        </div>
      </div>
    </div>
  </div>

خواص

ویژگی های hotel priceSpecification به شرح زیر است:

اموال مورد نیاز؟ تایپ کنید توضیحات
Hotel.Offer.priceSpecification.price Required float

کل قیمت شامل مالیات و هزینه های هتل.

نرخ گوگل همیشه باید در صفحه فرود شما همراه با جزئیات کامل نرخ شما حاشیه نویسی شود. حاشیه نویسی جزئیات نرخ به شما امکان می دهد بررسی های دقیق قیمت را کامل کنید. گوگل هم قیمت هتل و هم در سطح اتاق را می پذیرد.

Hotel.Offer.priceSpecification.priceCurrency Required currency کد ارز سه حرفی به قیمت مشخص شده. به عنوان مثال: "USD" .
Hotel.Offer.priceSpecification.priceComponent Optional UnitPriceSpecification[]

تفکیک کل قیمت شامل مالیات و هزینه های هتل. دو نوع داده ساختار یافته قیمت وجود دارد:

  • CompoundPriceSpecification تفکیک قیمت را ارائه می دهد تا شامل موارد زیر باشد:

    • نرخ پایه: قیمت پایه برای هر شب

    • مالیات به ازای اقامت: قیمت هر شب همراه با مالیات.

    • هزینه برای هر نفر: قیمت هر شب برای هر نفر.

    • تخفیف: مقدار کسر.

  • UnitPriceSpecification برای تعیین نوع هزینه ها استفاده می شود. برای تعیین هزینه های اضافی باید مقادیر PriceComponentTypeEnumeration را وارد کنید.

    مقادیر PriceComponentTypeEnumeration عبارتند از:

    • Discount : تخفیف عمومی نسبت به قیمت.

    • ResortFee : هزینه اضافی است که باید در هتل پرداخت شود. بسته به نوع مسکن می تواند متفاوت باشد.

    • GenericTax : این یک مالیات متفرقه اضافی است.

    • ServiceFee : هزینه اضافی است که توسط کانال رزرو دریافت می شود.

    • TransferFee : این یک هزینه اجباری برای حمل و نقل به هتل است که توسط هتل یا کانال رزرو دریافت می شود.

شما باید مقادیر را در ویژگی priceComponentType تنظیم کنید. اگر انتخاب کنید که UnitPriceSpecification را شامل شود، همه مقادیر مورد نیاز است و باید در ویژگی UnitPriceSpecification مشخص شود.

Hotel.Offer.priceSpecification.priceComponent. potentialAction Optional PayAction

نقطه پرداخت هتل. جریان های پرداخت هتل شامل قیمت هایی است که در زمان خروج در سایت رزرو و در هتل در هنگام تحویل گرفتن هزینه می شود.

برای نشان دادن نقطه پرداخت باید از ویژگی potentialAction استفاده کنید که همراه با فیلد " recipient " PayAction است. برای کسب اطلاعات بیشتر در مورد دارایی recipient به PayAction مراجعه کنید.

Google از دو تنظیمات زیر برای گیرنده PayAction پشتیبانی می‌کند:

  • recipient.@type = "OnlineBusiness" به پرداختی اطلاق می شود که در زمان رزرو توسط تاجر آنلاین جمع آوری می شود. اگر potentialAction مشخص نشده باشد، این تنظیم پیش فرض است.

  • recipient.@type = "Hotel" به مبلغ پرداختی در هتل اشاره دارد.

نمونه ها

نمونه های JSON-LD

قیمت

در زیر یک مثال اساسی از اضافه کردن داده های ساختار یافته قیمت به صفحه وب شما است. چندین پیشنهاد در سطح هتل را می توان در ملک makesOffer گنجاند.

اگر بخواهید ویژگی address را مشخص کنید، انواع PostalAddress مانند addressCountry ، postalCode ، streetAddress و سایر فیلدها اجباری هستند. نرخ نمایش داده شده توسط Google باید ابتدا در ویژگی makesOffer ذکر شود. مبلغ قیمت مشخص شده شامل کلیه مالیات های قابل اجرا می باشد. 

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {
    "@type": "PostalAddress",
    "addressCountry": "AT",
    "addressLocality": "Innsbruck",
    "addressRegion": "Tyrol",
    "postalCode": "6020",
    "streetAddress": "Technikerstrasse 21"
  },
  "makesOffer": [
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    },
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1200.74,
        "priceCurrency": "USD"
      }
    },
    ...
  ]
}

تفکیک قیمت

در زیر نمونه ای از ویژگی priceSpecification با تفکیک قیمت آورده شده است. نرخ پایه، مالیات هایی مانند مالیات عمومی و تخفیف با استفاده از جزء UnitPriceSpecification تعریف می شوند. به یاد داشته باشید که قسمت priceComponentType را با مقادیر مربوط به مؤلفه UnitPriceSpecification تنظیم کنید.

قیمت کل برای مدت اقامت باید در ویژگی CompoundPriceSpecification مشخص شود. تفکیک قیمت باید در ویژگی priceComponent مشخص شود. 

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {...},
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": 1150,
          "priceCurrency": "USD"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": 172.74,
          "priceCurrency": "USD",
          "priceComponentType": "GenericTax"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": -100,
          "priceCurrency": "USD",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

نقطه پرداخت

در زیر نمونه ای از مشخصات potentialAction در استفاده از نوع گیرنده PayAction آمده است.

قیمت کل بسته 1170 دلار است و وب سایت آنلاین بخشی از قیمت کل را که 1150 دلار در زمان رزرو مشخص شده با استفاده از "@type": "OnlineBusiness" دریافت می کند و کاربر باید 20 دلار باقی مانده را در زمان رزرو بپردازد. ورود به هتل که با استفاده از @type": "Hotel" .

شما باید مؤلفه potentialAction را مشخص کنید تا در زمان رزرو و در هتل، پرداخت را به طور کامل انجام دهید. اگر مشخص نشده باشد، payAction پرداخت را در زمان رزرو به عنوان روش پرداخت پیش‌فرض تفسیر می‌کند.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00]",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1170,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "price": 1150,
          "priceCurrency": "USD",
          "potentialAction": {
            "@type": "https://schema.org/PayAction",
            "recipient": {
              "@type": "OnlineBusiness",
              "name": "myonlinebusiness"
            }
          }
        },
        {
          "@type": "UnitPriceSpecification",
          "price": 20,
          "priceCurrency": "USD",
          "potentialAction": {
            "@type": "https://schema.org/PayAction",
            "recipient": {
              "@type": "Hotel",
              "name": "The Langham, Boston",
              "address": { ... }
            }
          }
        }
      ]
    }
  }
}

نمونه میکروداده

تفکیک قیمت

در زیر نمونه ای از ویژگی priceSpecification با تفکیک قیمت آورده شده است. نرخ پایه، مالیات هایی مانند مالیات عمومی و تخفیف با استفاده از جزء UnitPriceSpecification تعریف می شوند. به یاد داشته باشید که ویژگی name را با مقادیر مربوط به مؤلفه UnitPriceSpecification تنظیم کنید.

قیمت کل برای مدت اقامت باید در ویژگی CompoundPriceSpecification مشخص شود. تفکیک قیمت باید در ویژگی priceComponent مشخص شود. 

<div itemscope itemtype="https://schema.org/Hotel">
  <meta itemprop="name" content="ACME Hotel"/>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemscope itemtype="https://schema.org/PostalAddress" itemprop="address">
    <meta itemprop="addressCountry" content="US" />
    <meta itemprop="addressLocality" content="Mountain View" />
    <meta itemprop="addressRegion" content="Santa Clara" />
    <meta itemprop="postalCode" content="94040" />
    <meta itemprop="streetAddress" content="123 Main street" />
  </div>
  <div itemscope itemtype="https://schema.org/Offer   https://schema.org/LodgingReservation"  itemprop="makesOffer">
    <meta itemprop="checkinTime" content="2023-03-10 15:00:00" />
    <meta itemprop="checkoutTime" content="2023-03-16 10:00:00"/>
    <div itemscope itemtype="https://schema.org/CompoundPriceSpecification"   itemprop="priceSpecification">
    <meta itemprop="price" content="1222.74" />
    <meta itemprop="priceCurrency" content="USD" />
      <div itemscope itemtype="https://schema.org/UnitPriceSpecification"    itemprop="priceComponent">
        <meta itemprop="name" content="" />
        <meta itemprop="price" content="1150" />
        <meta itemprop="priceCurrency" content="USD" />
      </div>
      <div itemscope itemtype="https://schema.org/UnitPriceSpecification"  itemprop="priceComponent">
        <meta itemprop="name" content="GenericTax" />
        <meta itemprop="price" content="172.74" />
        <meta itemprop="priceCurrency" content="USD" />
        <meta itemprop="priceComponentType" content="GenericTax" />
      </div>
      <div itemscope itemtype="https://schema.org/UnitPriceSpecification"   itemprop="priceComponent">
        <meta itemprop="name" content="Discount" />
        <meta itemprop="price" content="-100" />
        <meta itemprop="priceCurrency" content="USD" />
        <meta itemprop="priceComponentType" content="Discount" />
      </div>
    </div>
  </div>
</div>

دارای ویژگی hasMerchantReturnPolicy

این دارایی برای حاشیه نویسی خط مشی بازپرداخت تاجر در برنامه های سفر استفاده می شود. 

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

نحو

hasMerchantReturnPolicy دارای نحو زیر است:

JSON-LD 

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "priceSpecification": { ... },
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "refundType": "https://schema.org/FullRefund",
      "merchantReturnDays": "YYYY-MM-DD[THH:mm:ss]",
      "restockingFee": 0
    }
  }
}

اموال

ویژگی hasMerchantReturnPolicy زیر است:

صفت مورد نیاز؟ تایپ کنید توضیحات
Offer.hasMerchantReturnPolicy Optional MerchantReturnPolicy

سیاست بازپرداخت تاجر. شرکا باید از MerchantReturnPolicy.restockingFee برای نشان دادن سیاست های لغو استفاده کنند که کل مبلغ را برای مدت اقامت بازپرداخت نمی کند.

اگر hasMerchantReturnPolicy مشخص نشده باشد یا خالی بماند، فرض می شود که مبلغ غیرقابل استرداد است. می‌توانید با استفاده از ویژگی returnPolicyCategory: MerchantReturnNotPermitted خط‌مشی غیر قابل استرداد را مشخص کنید.

مثال

سیاست بازگشت

در زیر یک مثال اساسی از داده های ساختاریافته برای یک هتل با جزئیات اتاق و قیمت کل با مالیات و کارمزد ارائه شده است. این مثال نشان‌دهنده اقامتی است که می‌توان آن را بدون هیچ هزینه‌ای تا ساعت ۱۱ شب (UTC) در ۱۸ دسامبر ۲۰۲۳ لغو کرد. شرکا باید از "MerchantReturnPolicy.restockingFee" برای نشان دادن سیاست‌های لغو استفاده کنند که کل مبلغ اقامت را بازپرداخت نمی‌کند. restockingFee پیش‌فرض 0 دلار است. 

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "description": "Beautiful resort in the outskirts of the city",
  "address": {...},
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-12-15 16:00:00",
    "checkoutTime": "2023-12-20 11:00:00",
    "priceSpecification": {...},
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "refundType": "https://schema.org/FullRefund",
      "merchantReturnDays": "2023-12-18 23:00:00",
      "restockingFee": 0
    }
  }
}

ویژگی eligibleCustomerType

از این ویژگی می توان برای حاشیه نویسی برنامه های پاداش ارائه شده برای مشتریان عضویت هتل استفاده کرد. 

"eligibleCustomerType": "RewardsMember",
"priceSpecification": {
    "@type": "CompoundPriceSpecification",
    "price": "float",
    "priceCurrency": "currency"
 }

نحو

ویژگی eligibleCustomerType دارای نحو زیر است:

JSON-LD 

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "eligibleCustomerType": "RewardsMember",
    "priceSpecification": { ... }
  }
}

اموال

ویژگی زیر ویژگی eligibleCustomerType است:

صفت مورد نیاز؟ تایپ کنید توضیحات
Offer.eligibleCustomerType Optional BusinessEntityType

برنامه های وفاداری یا جوایز اعضا که برای مشتریان ارائه می شود.

بسیاری از صفحات هتل نرخ‌های اعضا را همراه با نرخ‌های عمومی نمایش می‌دهند تا کاربران را تشویق کنند تا در برنامه‌های وفاداری خود ثبت نام کنند. با تنظیم ویژگی Offer.eligibleCustomerType می‌توان نرخ‌های محدود شده به مخاطبان خاص، مانند نرخ‌های اعضا را تعیین کرد.

نمونه ها

نرخ اعضا

در زیر یک مثال اساسی از قیمت گذاری اعضا یا مشخصات نرخ محصور شده برای برنامه های وفاداری است. مشتری "عضو پاداش" هتل است.

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {...},
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "name": "RewardsMember",
    "checkinTime": "2023-12-15 16:00:00",
    "checkoutTime": "2023-12-20 11:00:00",
    "eligibleCustomerType": "RewardsMember",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1342.74,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "Base rate",
          "price": 1069.98,
          "priceCurrency": "USD"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": 172.74,
          "priceCurrency": "currency"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "ResortFee",
          "price": 100,
          "priceCurrency": "USD"
        }
      ]
    }
  }
}

نرخ اعضا و منظم

این نمونه ای از حاشیه نویسی قیمت نرخ معمولی و عضو است. قیمت گذاری اعضا ابتدا لیست شده است و سپس نرخ های معمولی ذکر شده است. 

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {...},
  "makesOffer": [
    {
      "@type": ["Offer", "LodgingReservation"],
      "name": "RewardsMember",
      "checkinTime": "2023-12-15 16:00:00",
      "checkoutTime": "2023-12-20 11:00:00",
      "eligibleCustomerType": "RewardsMember",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1342.74,
        "priceCurrency": "USD",
        "priceComponent": [
          {
            "@type": "UnitPriceSpecification",
            "name": "Base rate",
            "price": 1069.98,
            "priceCurrency": "USD"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "GenericTax",
            "price": 172.74,
            "priceCurrency": "currency"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "ResortFee",
            "price": 100,
            "priceCurrency": "USD"
          }
        ]
      }
    },
    {
      "@type": ["Offer", "LodgingReservation"],
      "name": "regularRate",
      "checkinTime": "2023-12-15 16:00:00",
      "checkoutTime": "2023-12-20 11:00:00",
      "priceSpecification": {
        "price": 1572.24,
        "priceCurrency": "USD",
        "priceComponent": [
          {
            "@type": "UnitPriceSpecification",
            "name": "Base rate",
            "price": 1369.98,
            "priceCurrency": "USD"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "GenericTax",
            "price": 202.26,
            "priceCurrency": "currency"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "ResortFee",
            "price": 100,
            "priceCurrency": "USD"
          }
        ]
      }
    }
  ]
}

داده های ساختار یافته HotelRoom

ملک offers

حاشیه نویسی offers برای نشانه گذاری برنامه های سفر اتاق شما استفاده می شود. شما باید از ویژگی offers برای مشخصات HotelRoom استفاده کنید. 

"offers": {
  "@type": ["Offer", "LodgingReservation"],
  "identifier": "hotel-room-id-1234",
  "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
  "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
  "priceSpecification": {...}
}

نحو

ویژگی offers دارای نحو زیر است:

JSON-LD 

{
  "@context": "https://schema.org",
  "@type": "HotelRoom",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      ...
    }
  }
}

خواص

املاک offers به شرح زیر است:

اموال مورد نیاز؟ تایپ کنید توضیحات
offers Required Offer and LodgingReservation

مشخصات قیمت اتاق برای برنامه سفر داده شده.

ویژگی offers می تواند شامل مجموعه ای از پیشنهادات باشد.

LodgingReservation.checkinTime Required DateTime

زمان ورود در منطقه زمانی کاربر. اگر منطقه زمانی شما ذکر نشده باشد، منطقه زمانی هتل در نظر گرفته می شود.

LodgingReservation.checkoutTime Required DateTime

زمان خروج در منطقه زمانی کاربر. اگر منطقه زمانی شما ذکر نشده باشد، منطقه زمانی هتل در نظر گرفته می شود.

مثال

ارائه می دهد

در زیر یک مثال اساسی برای تعیین offers در ویژگی HotelRoom آورده شده است. 

{
  "@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 دارای نحو زیر است:

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 است.

اشغال یک ویژگی صریح HotelRoom است، نه برای یک Offer خاص. نرخ ها فقط باید برای اشغال درخواست شده برچسب گذاری شوند.

containsPlace Optional (Recommended) LocationFeatureSpecification

برای حاشیه نویسی نرخ های سطح اتاق مرتبط با اتاق های خاص استفاده می شود. همچنین می توان از آن برای مشخص کردن امکانات موجود در اتاق استفاده کرد.

درباره نحوه استفاده از containsPlace در ویژگی amenityFeature بیشتر بیاموزید.

نمونه ها

اتاق هتل

در زیر یک مثال اساسی از تخت ها و اشغال ها برای مشخصات اتاق آورده شده است. 

{
  "@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 آورده شده است . 

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "containsPlace": {
    "@type": ["HotelRoom", "Product"],
    "name": "Deluxe Room, 1 King Bed",
    "identifier": "hotel-room-id",
    "bed": {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    "occupancy": {
      "@type": "QuantitativeValue",
      "value": 2
    },
    "amenityFeature": {
      "@type": "LocationFeatureSpecification",
      "name": "Minibar",
      "value": true
    },
    "offers": {
      "@type": ["Offer", "LodgingReservation"],
      "identifier": "rate-plan-id-of-member-rate",
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    }
  }
}

HotelRoom priceSpecification ملک

مشخصات قیمت اتاق هتل مشابه مشخصات قیمت هتل است. تفاوت این است که قیمت اتاق ها با استفاده از ویژگی Product.offers به ​​جای ویژگی Hotel.makesOffer مشخص می شود. 

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

نحو

ویژگی priceSpecification برای اتاق های هتل دارای نحو زیر است:

JSON-LD 

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  ...
  "bed": {
    "@type": "BedDetails",
    "numberOfBeds": "integer",
    "typeOfBed": "KING"
  },
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": "integer"
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": "float",
          "priceCurrency": "currency"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "GenericTax"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

خواص

ویژگی های HotelRoom priceSpecification به شرح زیر است:

اموال مورد نیاز؟ تایپ کنید توضیحات
Hotel.Offer.priceSpecification.price Required float

قیمت هر اتاق شامل مالیات و هزینه های Product .

نرخ گوگل همیشه باید در صفحه فرود شما همراه با جزئیات کامل نرخ شما حاشیه نویسی شود. حاشیه نویسی جزئیات نرخ به شما امکان می دهد بررسی های دقیق قیمت را کامل کنید. گوگل هم قیمت هتل و هم در سطح اتاق را می پذیرد.

Hotel.Offer.priceSpecification.priceCurrency Required currency کد ارز سه حرفی به قیمت مشخص شده. به عنوان مثال: "USD" .
Hotel.Offer.priceSpecification.priceComponent Optional UnitPriceSpecification[]

تفکیک کل قیمت شامل مالیات و کارمزد اتاق هتل و اشغال با پیشنهادات مرتبط با HotelRoom و Product . دو نوع داده ساختار یافته قیمت وجود دارد:

  • CompoundPriceSpecification تفکیک قیمت را ارائه می دهد تا شامل موارد زیر باشد:

    • نرخ پایه: قیمت پایه برای هر شب

    • مالیات به ازای اقامت: قیمت هر شب همراه با مالیات.

    • هزینه برای هر نفر: قیمت هر شب برای هر نفر.

      occupancy یک ویژگی صریح HotelRoom است، نه برای یک Offer خاص. نرخ ها فقط باید برای اشغال درخواست شده برچسب گذاری شوند.

    • تخفیف: مقدار کسر.

  • UnitPriceSpecification برای تعیین نوع هزینه ها استفاده می شود. برای تعیین هزینه های اضافی باید مقادیر PriceComponentTypeEnumeration را وارد کنید.

    مقادیر PriceComponentTypeEnumeration عبارتند از:

    • Discount : تخفیف عمومی نسبت به قیمت.

    • ResortFee : هزینه اضافی است که باید در هتل پرداخت شود. بسته به نوع مسکن می تواند متفاوت باشد.

    • GenericTax : این یک مالیات متفرقه اضافی است.

    • ServiceFee : هزینه اضافی است که توسط کانال رزرو دریافت می شود.

    شما باید مقادیر را در ویژگی name UnitPriceSpecification تنظیم کنید. اگر بخواهید تفکیک قیمت را درج کنید، همه مقادیر مورد نیاز است و باید در مؤلفه UnitPriceSpecification مشخص شود.

نمونه ها

قیمت کل اتاق

در زیر یک مثال اساسی از تعریف قیمت کل برای مدت اقامت و قیمت به ازای هر اشغال آورده شده است. 

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room King, 1 Single Bed",
  "identifier": "hotel-room-id-1234",
  "bed": [
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "SINGLE"
    }
  ],
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": 2
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1232.74,
      "priceCurrency": "USD"
    }
  },
  ...
}

تفکیک قیمت اتاق

در زیر نمونه ای از قیمت هر اتاق یا پلان آورده شده است. تفکیک قیمت برای نوع اتاق مانند اتاق Deluxe و bed و نوع occupancy مانند تخت KING و SINGLE و ظرفیت 2 مهمان تعریف شده است. 

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room King, 1 Single Bed",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "identifier": "rate-plan-id-of-member-rate",
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "bed": [
      {
        "@type": "BedDetails",
        "numberOfBeds": 1,
        "typeOfBed": "KING"
      },
      {
        "@type": "BedDetails",
        "numberOfBeds": 1,
        "typeOfBed": "SINGLE"
      }
    ],
    "occupancy": {
      "@type": "QuantitativeValue",
      "value": 2
    },
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "Base rate",
          "price": 1150,
          "priceCurrency": "USD"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": 172.74,
          "priceCurrency": "USD",
          "priceComponentType": "GenericTax"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": -100,
          "priceCurrency": "USD",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

includesObject ویژگی Object

این ویژگی برای حاشیه نویسی خدمات ویژه نرخ ارائه شده در هتل یا اتاق مانند گزینه های غذا و خدمات نوکر استفاده می شود. می‌توانید includesObject در ملک Hotel یا HotelRoom حاشیه‌نویسی کنید. 

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

نحو

includesObject دستور زیر را برای سرویس‌های نرخ ویژه موجود در اتاق دارد:

JSON-LD 

{
  "@context": "https://schema.org",
  ...
  "@type": ["HotelRoom", "Product"],
  ...
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency"
    },
    "includesObject": [
      {
        "@type": "TypeAndQuantityNode",
        "typeOfGood": {
          "@type": "Service",
          "name": "Valet"
        }
      },
      {
        "@type": "TypeAndQuantityNode",
        "amountOfThisGood": "float",
        "unitText": "currency",
        "typeOfGood": {
          "@type": "FoodService",
          "name": "MealCredit"
        }
      }
    ]
  }
}

اموال

includesObject دارای ویژگی زیر است:

صفت مورد نیاز؟ تایپ کنید توضیحات
Offer.includesObject Optional TypeAndQuantityNode

خدمات ارائه شده در هتل یا اتاق.

ویژگی های مربوط به نرخ با ویژگی includesObject گنجانده شده است. فیلد نام در "TypeAndQuantityNode.typeOfGood" باید برای نشان دادن نوع خدمات مانند خدمتکار یا سرویس غذا استفاده شود.

ویژگی‌های ویژه نرخ نیز ممکن است در پیشنهادات سطح پایه گنجانده شوند، یا ممکن است به‌عنوان افزونه‌ها با قیمت اضافی مشخص شوند.

includesObject به مقداری از نوع TypeAndQuantityNode به شرح زیر نیاز دارد:

  • BreakfastIncluded
  • DinnerIncluded
  • Valet
  • MealCredit

مثال

خدمات

در زیر یک مثال اساسی از ویژگی‌های نرخ ویژه برای پارکینگ و خدمات غذا ارائه شده است. ویژگی‌های مخصوص نرخ باید با ویژگی "Offer.includesObject" مشخص شوند. فیلد نام در "TypeAndQuantityNode.typeOfGood" باید برای نشان دادن نوع سرویس استفاده شود. 

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room, 1 King Bed",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "identifier": "rate-plan-id-of-member-rate",
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD"
    },
    "includesObject": [
      {
        "@type": "TypeAndQuantityNode",
        "typeOfGood": {
          "@type": "Service",
          "name": "Valet"
        }
      },
      {
        "@type": "TypeAndQuantityNode",
        "amountOfThisGood": 50,
        "unitText": "USD",
        "typeOfGood": {
          "@type": "FoodService",
          "name": "MealCredit"
        }
      }
    ]
  }
}

اموال availability

ویژگی offer.availability برای حاشیه نویسی برنامه های سفر فروخته شده برای اتاق های هتل استفاده می شود. 

"offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/SoldOut"
}

نحو

ویژگی availability دارای نحو زیر است:

JSON-LD 

{
  "@context": "https://schema.org",
  ...
  "@type": ["HotelRoom", "Product"],
  "name": "room-type",
  "identifier": "hotel-room-id-1234",
  "bed": {
    "@type": "BedDetails",
    "numberOfBeds": "integer",
    "typeOfBed": "KING"
  },
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": "integer"
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/SoldOut"
  }
}

اموال

ویژگی های availability موارد زیر است:

صفت مورد نیاز؟ تایپ کنید توضیحات
Offer.availability Optional ItemAvailability

در دسترس بودن هتل یا اتاق.

نرخ‌ها از schema.org/Offer استخراج می‌شوند و اطلاعات نرخ با استفاده از schema.org/Hotel یا schema.org/HotelRoom ایجاد نمی‌شود. این بدان معنی است که حتی سفرهای فروخته شده نیز باید یک پیشنهاد داشته باشند.

پیشنهادی بدون priceSpecification در دسترس نیست. پیشنهادات غیرقابل دسترس باید به عنوان "Offer.availability= https://schema.org/SoldOut " مشخص شود.

در صورتی که پیشنهاد با یک تعریف معتبر priceSpecification. مشروح شده باشد، نیازی به تعیین Offer.availability نیست.

مثال

در دسترس بودن

مثال زیر یک مثال اساسی برای نشان دادن در دسترس نبودن اتاق هتل است. باید نوع تخت، تعداد تخت ها و جزئیات اشغال اتاق مشخص شده را درج کنید. 

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room, 1 King Bed",
  "identifier": "hotel-room-id-1234",
  "bed": [
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "SINGLE"
    }
  ],
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": 2
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "availability": "https://schema.org/SoldOut",
    "priceSpecification": {...}
  }
}

ویژگی امکانات amenityFeature

امکانات رفاهی را می توان در نوع Hotel یا HotelRoom با استفاده از ویژگی amenityFeature مشخص کرد. باید از ویژگی containsPlace برای مشخص کردن امکانات ارائه شده در اتاق استفاده کنید. 

{
  "@type": "Hotel",
  "amenityFeature": [
    {
      "@type": "LocationFeatureSpecification",
      "name": "HotTub",
      "hoursAvailable": {
        "@type": "OpeningHoursSpecification",
        "opens": "HH:mm:ss",
        "closes": "HH:mm:ss"
      }
    },
    {
      "@type": "LocationFeatureSpecification",
      "name": "GymFitnessEquipment",
      "value": "boolean"
    }
  ],
  "containsPlace": {
    "@type": "HotelRoom",
    "amenityFeature": [
      {
        "@type": "LocationFeatureSpecification",
        "name": "Minibar",
        "value": true
      },
      {
        "@type": "LocationFeatureSpecification",
        "name": "Smoking",
        "value": false
      }
    ]
  }
}

نحو

amenityFeature و ویژگی containsPlace دارای نحو زیر است:

JSON-LD 

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "amenityFeature": {
    "@type": "LocationFeatureSpecification",
    "name": "HotTub",
    "hoursAvailable": {
      "@type": "OpeningHoursSpecification",
      "opens": "HH:mm:ss",
      "closes": "HH:mm:ss"
    }
  },
  "containsPlace": {
    "@type": "HotelRoom",
    "amenityFeature": {
      "@type": "LocationFeatureSpecification",
      "name": "Minibar",
      "value": "boolean"
    }
  }
}

امکانات رفاهی

امکانات زیر در ویژگی name مجاز و تعریف شده است.

صفت مورد نیاز؟ تایپ کنید توضیحات
amenityFeature.AC Optional boolean این که آیا ملک دارای تهویه مطبوع است.
amenityFeature.AirportShuttle Optional boolean این که آیا میزبان حمل و نقل به و از فرودگاه یا پایانه های دیگر را فراهم می کند.
amenityFeature.Balcony Optional boolean این که آیا اقامتگاه دارای بالکن است.
amenityFeature.BeachAccess Optional boolean اینکه آیا ملک به ساحل عمومی نزدیک به ملک دسترسی دارد یا خیر.
amenityFeature.ChildFriendly Optional boolean این که آیا ملک برای کودکان مناسب است.
amenityFeature.Crib Optional boolean این که آیا ملک یک تخت کودک فراهم می کند.
amenityFeature.Elevator Optional boolean این که آیا ملک دارای آسانسور است.
amenityFeature.FirePlace Optional boolean این که آیا اقامتگاه دارای شومینه است.
amenityFeature.FreeBreakfast Optional boolean این که آیا ملک دارای صبحانه رایگان برای همه مهمانان است. از ویژگی‌های نرخ استفاده کنید تا مشخص کنید که آیا صبحانه فقط برای برنامه‌های نرخ خاص گنجانده شده است یا خیر.
amenityFeature.GymFitnessEquipment Optional boolean خواه این ملک دارای سالن بدنسازی باشد یا هر وسیله تناسب اندام.
amenityFeature.Heating Optional boolean این که آیا محل اقامت دارای گرمایش است.
amenityFeature.HotTub Optional boolean این که آیا ملک دارای جکوزی است.
amenityFeature.InstantBookable Optional boolean اینکه آیا ملک فوراً از طریق فرآیند پرداخت قابل رزرو است یا خیر. جایگزین منتظر تایید است.
amenityFeature.IroningBoard Optional boolean این که آیا ملک میز اتو دارد.
amenityFeature.Kitchen Optional boolean این که آیا محل اقامت آشپزخانه دارد.
amenityFeature.Microwave Optional boolean این که آیا محل اقامت مایکروویو در دسترس دارد.
amenityFeature.OpenAirBath(Hotels only) Optional boolean این که آیا محل اقامت دارای حمام هوای آزاد است. اگر در سطح اتاق مشخص شده باشد، حمام باید فقط برای ساکنان اتاق خصوصی باشد.
amenityFeature.OutdoorGrill Optional boolean این که آیا ملک دارای کباب پز است.
amenityFeature.OvenStove Optional boolean این که آیا ملک دارای اجاق گاز است.
amenityFeature.Patio Optional boolean این که آیا ملک دارای پاسیو است.
amenityFeature.Pool Optional boolean این که آیا محل اقامت استخر دارد.
amenityFeature.PrivateBeachAccess Optional boolean این که آیا ملک دسترسی اختصاصی به ساحل غیر عمومی دارد.
amenityFeature.SelfCheckinCheckout Optional boolean اینکه آیا ملک از ورود و خروج خود پشتیبانی می‌کند.
amenityFeature.WasherDryer Optional boolean این که آیا محل اقامت دارای لوازم خشکشویی است.
amenityFeature.Wifi Optional boolean اینکه آیا ملک دارای Wifi است.
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 شب استخر باز است و سالن بدنسازی در این ملک وجود ندارد. اتاق هتل غیرسیگاری است و دارای مینی بار است. 

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