مرجع البيانات المنظَّمة لأسعار الفنادق

توفّر هذه الصفحة مرجعًا لإضافة ترميزات البيانات المنظَّمة إلى فنادقك. بيانات التسعير

نظرة عامة

تُستخدَم البيانات المنظَّمة لأسعار الفنادق للشرح والتحقّق من المشكلة وعرضها بالتفصيل. أسعار الفنادق المُدرَجة على موقعك الإلكتروني بغض النظر عن واجهة المستخدم. هذا النمط يشمل أيضًا السعر الأساسي والأسعار والغرف والرسوم الحقول المتعلقة بالضرائب والأسعار.

تنصح Google الشركاء بإضافة تعليقات توضيحية على صفحات الويب لديهم باستخدام هي بيانات منظَّمة يمكن لبرامج الزحف قراءتها آليًا مقدمة من schema.org، لاستخلاص الأسعار بدقة من صفحاتك على الويب.

ويسمح ذلك بتوسيع نطاق عمليات التحقّق من دقة الأسعار من خلال تحسين موثوقية برامج الزحف. تتمثل الفائدة التي تحصل عليها في زيادة عدد عمليات التحقّق من دقة الأسعار وإمكانية تصحيح الأخطاء المتعلقة بدقة الأسعار بشكل مباشر، وأيضًا للحصول على نتيجة دقيقة لدقة الأسعار.

إذا كنت لا تزال مبتدئًا في مجال البيانات المنظَّمة، يمكنك الاطّلاع على المزيد من المعلومات حول مفردات البيانات المنظَّمة. وتنسيقه

تنصح "الفنادق على Google" باستخدام تنسيق JSON-LD لإضافة تعليقات توضيحية إلى صفحاتك على الويب. ارجع إلى التنسيقات المتوافقة لمعرفة المزيد من المعلومات حول التنسيقات المقبولة الأخرى. توفر هذه الوثائق محتوى مرجعي تفصيلي خاص بتنفيذ البيانات المنظَّمة في "الفنادق على 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 البنية التالية:

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

وقت تسجيل المغادرة حسب المنطقة الزمنية الخاصة بالمستخدم إذا لم تكن منطقتك الزمنية المذكورة، يتم أخذ المنطقة الزمنية للفندق في الاعتبار.

مثال

makesOffer

في ما يلي مثال أساسي لإضافة تعليقات توضيحية إلى عروض فنادقك. يمكنك لتحديد عروض متعددة لبرنامج رحلة، ولكن عليك تحديد المعدّل الذي تعرضه Google يليه الأسعار الأخرى أولاً مبلغ السعر المحددة تتضمن جميع الضرائب السارية.

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

Hotel priceSpecification الموقع الإلكتروني

تُستخدَم هذه السمة لإضافة تعليقات توضيحية إلى معلومات الأسعار الخاصة بفندقك أو فندقك. غرف. هناك سمتان إضافيتان مطلوبتان لإضافة تعليقات توضيحية إلى الأسعار والضرائب. يجب استخدام CompoundPriceSpecification. لتحديد معلومات التسعير الإجمالية، مثل السعر الأساسي والضرائب والخصومات استخدِم UnitPriceSpecification. لتحديد ضرائب إضافية أو أنواع خاصة من الرسوم مثل ResortFee وGenericTax وServiceFee. priceSpecification هذه السمة مع السمة Offer.

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

البنية

تستخدم السمة Hotel priceSpecification البنية التالية:

JSON-LD

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

البيانات الجزئية

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

أماكن إقامة

في ما يلي سمات hotel priceSpecification:

الموقع مطلوب؟ النوع الوصف
Hotel.Offer.priceSpecification.price Required float

السعر الإجمالي بما في ذلك الضرائب والرسوم للفندق.

يجب دائمًا إضافة تعليقات توضيحية إلى سعر Google على صفحتك المقصودة التفاصيل الكاملة للسعر. من خلال التعليق التوضيحي على تفاصيل السعر، يمكنك إكمال عمليات التحقق من دقة الأسعار تقبل Google كلّاً من مستوى الفندق وعلى مستوى الغرفة. الأسعار.

Hotel.Offer.priceSpecification.priceCurrency Required currency رمز عملة مكوَّن من ثلاثة أحرف للسعر المحدد. على سبيل المثال: "USD" .
Hotel.Offer.priceSpecification.priceComponent Optional UnitPriceSpecification[]

تفاصيل السعر الإجمالي، بما في ذلك الضرائب والرسوم للفندق. يتوفّر نوعان من البيانات المنظَّمة للأسعار:

  • يقدّم CompoundPriceSpecification تفاصيل الأسعار إلى ما يلي:

    • السعر الأساسي: السعر الأساسي لليلة

    • الضرائب لكل إقامة: سعر الليلة مع الضرائب

    • الرسوم المفروضة على كل راكب: هي سعر الإقامة في الليلة الواحدة.

    • الخصم: مبلغ الخصم.

  • يتم استخدام UnitPriceSpecification لتحديد نوع الرسوم. يجب تضمين PriceComponentTypeEnumeration لتحديد الرسوم الإضافية.

    قيم PriceComponentTypeEnumeration هي:

    • Discount: الخصم العام على السعر.

    • ResortFee: هذا رسوم إضافية يجب أن يتم الدفع له في الفندق. يمكن أن يختلف العدد حسب نوع الإقامة. الموقع.

    • GenericTax: إنّه نطاق إضافي متنوع الضريبة.

    • ServiceFee: وهو رسم إضافي يتم التي تحصّلها قناة الحجز

    • TransferFee: إنه رسم إلزامي بحكمة وسائل النقل إلى الفندق، والتي يتم جمعها إما عن طريق الفندق أو الحجز .

يجب ضبط القيم في السمة priceComponentType . تكون جميع القيم مطلوبة إذا اخترت تضمين UnitPriceSpecification ويجب تحديده في الموقع: UnitPriceSpecification.

Hotel.Offer.priceSpecification.priceComponent. potentialAction Optional PayAction

نقطة الدفع في الفندق، وتشمل إجراءات الدفع للفندق الأسعار التي يتم تحصيلها خلال وقت تسجيل المغادرة على موقع الحجز الإلكتروني الفندق أثناء تسجيل الوصول.

عليك استخدام السمة potentialAction المضمّنة مع سمات PayAction. "recipient" للإشارة إلى نقطة الدفع. ارجع إلى PayAction للاطّلاع على مزيد من المعلومات مزيد من المعلومات حول خاصية recipient.

تتيح Google الإعدادين التاليين لجهاز "PayAction" المستلم:

  • يشير recipient.@type = "OnlineBusiness" إلى عمليات الدفع. التي يجمعها التاجر على الإنترنت في وقت الحجز هذه هي الإعداد التلقائي في حال عدم تحديد potentialAction.

  • يشير recipient.@type = "Hotel" إلى طريقة الدفع. التي يتم جمعها في الفندق.

أمثلة

أمثلة على JSON-LD

السعر

في ما يلي مثال أساسي على إضافة البيانات المنظَّمة للسعر إلى صفحة الويب. يمكن تضمين عروض الفندق المتعددة في الموقع: makesOffer.

PostalAddress أنواع، مثل addressCountry وpostalCode و يُعتبر streetAddress والحقول الأخرى إلزامية إذا اخترت تحديد السمة address يجب إدراج السعر الذي تعرضه Google أولاً في الموقع: makesOffer. يشمل السعر المحدّد كل النفقات السارية. الضرائب

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

تفاصيل السعر

في ما يلي مثال على السمة priceSpecification مع السمة تفاصيل الأسعار. السعر الأساسي والضرائب مثل الضريبة العامة والخصم: باستخدام المكون UnitPriceSpecification. تذكر تعيين priceComponentType بالقيم المقابلة المكوِّن UnitPriceSpecification.

ويجب تحديد السعر الإجمالي لمدة الإقامة في الموقع: CompoundPriceSpecification. يجب أن تكون تفاصيل السعر على النحو التالي المحددة في السمة priceComponent.

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

نقطة الدفع

في ما يلي مثال على مواصفات potentialAction عند استخدام نوع مستلم PayAction.

يبلغ السعر الإجمالي للحزمة 1170 دولارًا أمريكيًا، ويُحصِّل الموقع الإلكتروني على الإنترنت جزءًا من السعر الإجمالي الذي يبلغ 1150 دولارًا أمريكيًا في وقت الحجز المحدد باستخدام "@type": "OnlineBusiness" وعلى المستخدم دفع المبلغ المتبقي البالغ 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.

مثال

سياسة الإرجاع

فيما يلي مثال أساسي على البيانات المنظمة لفندق يضم غرفة التفاصيل والسعر الإجمالي مع الضرائب والرسوم. يشير هذا المثال إلى إقامة يمكن إلغاء الاشتراك بدون أي رسوم حتى الساعة 11 مساءً (بالتوقيت العالمي المُنسّق) في 18 كانون الأول (ديسمبر) 2023 يجب على الشركاء استخدام "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 على مصفوفة من على مستوى خدمات Google.

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 لإضافة تعليقات توضيحية إلى العدد. الضيوف في الغرفة. يمكن تحديد السمتَين bed وoccupancy باستخدام السمة HotelRoom.

"@type": "Hotel",
"identifier": "hotel-id-1234",
"containsPlace": {
    "@type": ["HotelRoom", "Product"],
    "identifier": "hotel-room-id",
  "bed": {
    "@type": "BedDetails",
    "numberOfBeds": "integer",
    "typeOfBed": "KING"
  },
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": "integer"
  }
}

البنية

تستخدم السمتان bed وoccupancy البنية التالية:

JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "containsPlace": {
    "@type": ["HotelRoom", "Product"],
    "name": "room-name",
    "identifier": "hotel-room-id-1234",
    "bed": {
      "@type": "BedDetails",
      "numberOfBeds": "integer",
      "typeOfBed": "KING"
    },
    "occupancy": {
      "@type": "QuantitativeValue",
      "value": "integer"
    },
    "offers": {
      "@type": ["Offer", "LodgingReservation"],
      "identifier": "rate-plan-id-of-member-rate",
      "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
      "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": "float",
        "priceCurrency": "currency",
        "priceComponent": {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": "float",
          "priceCurrency": "currency"
        },
        ...
      }
    }
  }
}

لا يمكن ضبط السمتَين bed وoccupancy إلا باستخدام HotelRoom. الموقع. يمكن تضمين معلومات خاصة بالغرف، بما في ذلك الأسعار على مستوى الغرفة. إلى السمة Hotel من خلال السمة containsPlace. ارجع إلى مثال على مواصفات 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.

أمثلة

HotelRoom

فيما يلي مثال أساسي على الأسرّة وإشغالات غرفة المواصفات.

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

Hotel Room

في ما يلي مثال على إضافة تعليقات توضيحية إلى 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

يجب دائمًا إضافة تعليقات توضيحية إلى سعر Google على صفحتك المقصودة التفاصيل الكاملة للسعر. من خلال التعليق التوضيحي على تفاصيل السعر، يمكنك إكمال عمليات التحقق من دقة الأسعار تقبل Google كلّاً من مستوى الفندق وعلى مستوى الغرفة. الأسعار.

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، وتتّسع لنزيلَين.

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

includesObject الموقع الإلكتروني

تُستخدَم هذه السمة لإضافة تعليقات توضيحية إلى الخدمات الخاصة بالأسعار التي يقدّمها الفندق. أو الغرف مثل خيارات الوجبات وخدمة صفّ السيارات يمكنك إضافة تعليقات توضيحية. includesObject في السمة Hotel أو HotelRoom

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

البنية

تتضمّن "includesObject" البنية التالية للخدمات المتعلّقة بالسعر. المتاحة في الغرفة:

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"

ليس من الضروري أن يكون Offer.availability إذا تمت إضافة تعليق توضيحي إلى العرض الترويجي priceSpecification.

مثال

مدى توفّر الخدمة

في ما يلي مثال أساسي لعرض عدم توفّر غرف في الفنادق. إِنْتَ يجب أن تشمل نوع السرير وعدد الأسرّة وتفاصيل الإشغال للغرفة المحددة.

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

amenityFeature الموقع الإلكتروني

يمكن تحديد وسائل الراحة إما في النوع Hotel أو HotelRoom باستخدام الموقع "amenityFeature". يجب استخدام السمة containsPlace لتحديد وسائل الراحة المتوفرة في الغرفة.

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

البنية

في ما يلي السمات الخاصة بكل من amenityFeature وcontainsPlace. بناء الجملة:

JSON-LD

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

وسائل الراحة

إنّ وسائل الراحة التالية مسموح بها وتحديدها في السمة name.

السمة مطلوب؟ النوع الوصف
amenityFeature.AC Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر مكيفات هواء.
amenityFeature.AirportShuttle Optional boolean تُستخدَم لتحديد ما إذا كان المضيف يوفّر خدمات نقل من وإلى المطار أو الأطراف الطرفية الأخرى.
amenityFeature.Balcony Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر شرفة.
amenityFeature.BeachAccess Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يتيح استخدام شاطئ عام بالقرب منه.
amenityFeature.ChildFriendly Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار مناسبًا للأطفال.
amenityFeature.Crib Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر سرير أطفال.
amenityFeature.Elevator Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يضم مصعدًا.
amenityFeature.FirePlace Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يضم موقد تدفئة.
amenityFeature.FreeBreakfast Optional boolean تُستخدَم لتحديد ما إذا كانت الإقامة تشمل وجبة فطور مجانية لجميع النزلاء. استخدام ميزات السعر للإشارة إلى ما إذا كان الفطور مشمولاً فقط لسعر محدّد الخطط.
amenityFeature.GymFitnessEquipment Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر صالة تمارين أو معدّات رياضية.
amenityFeature.Heating Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر التدفئة.
amenityFeature.HotTub Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر مغطس مياه ساخنة.
amenityFeature.InstantBookable Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار قابلاً للحجز بشكل فوري عبر إتمام الدفع. الدفع. والخيار البديل هو انتظار الحصول على موافقة.
amenityFeature.IroningBoard Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر ألواح كي.
amenityFeature.Kitchen Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر مطبخًا.
amenityFeature.Microwave Optional boolean تُستخدَم لتحديد ما إذا كان مكان الإقامة يوفّر ميكروويف.
amenityFeature.OpenAirBath(Hotels only) Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر حمّامًا في الهواء الطلق. في حال التحديد على مستوى الغرفة، يجب أن يكون الحمام خاصًا لنزلاء الغرفة فقط.
amenityFeature.OutdoorGrill Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر أدوات الشواء.
amenityFeature.OvenStove Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر موقد طهي.
amenityFeature.Patio Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر فناء.
amenityFeature.Pool Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر حوض سباحة.
amenityFeature.PrivateBeachAccess Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر إمكانية استخدام شاطئ خاص.
amenityFeature.SelfCheckinCheckout Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر إمكانية تسجيل الوصول والمغادرة ذاتيًا.
amenityFeature.WasherDryer Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر غسالات ملابس.
amenityFeature.Wifi Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر Wi-Fi.
amenityFeature.Smoking Optional boolean تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يسمح بالتدخين.
amenityFeature.InternetType Optional Enum

تحدّد هذه السمة نوع اتصال الإنترنت المتاح في المكان المخصّص للاستئجار.

القيمتان المسموح بإدراجهما هما:

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