הפניה לנתונים מובְנים של מחיר מלון

בדף הזה מוסבר איך להוסיף תגי עיצוב של נתונים מובְנים למלונות שלכם נתוני תמחור.

סקירה כללית

הנתונים המובְנים של מחירי המלון משמשים להסבר, לאימות ולהצגה בפירוט מחירי המלונות שמפורטים באתר שלכם, בלי קשר לממשק המשתמש. הזה כולל גם מחיר בסיס, תעריפים, חדרים, עמלות בשדות שקשורים למיסים ולתמחור.

Google ממליצה לשותפים להוסיף הערות לדפי האינטרנט שלהם באמצעות נתונים מובְנים קריאים למחשבים לסורקים; סופק על ידי schema.org, כדי לחלץ מחירים באופן מדויק. מדפי האינטרנט שלכם.

כך ניתן להגדיל את מספר הבדיקות של דיוק במחירים באמצעות שיפור של הסורקים. התועלת עבורך היא עלייה במספר אימותים של דיוק במחירים ויכולת לנפות באגים בבעיות דיוק במחירים באופן ישיר, וגם לשמור על ציון עקבי של דיוק במחיר.

אם זו הפעם הראשונה שאתם משתמשים בנתונים מובְנים, כדאי לעיין במידע נוסף על אוצר מילים בנושא נתונים מובְנים ופורמט.

מערכת 'Google בתי מלון' ממליצה על פורמט 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

שעת הצ'ק-אאוט באזור הזמן של המשתמש. אם אזור הזמן שלכם הוא לא ואז המערכת מביאה בחשבון את אזור הזמן של המלון.

דוגמה

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.

מחיר החבילה הכולל הוא 1,700 ש"ח, והחלק של החיובים באתר באינטרנט מהמחיר הכולל שהוא 1150 $במועד ההזמנה שצוין באמצעות "@type": "OnlineBusiness" והמשתמש צריך לשלם את שאר הסכום של 80 ש"ח שעת הצ'ק-אין במלון שמצוין בעזרת @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.

דוגמה

מדיניות החזרת מוצרים

דוגמה בסיסית לנתונים מובְנים של מלון עם חדר את הפרטים ואת המחיר הכולל, כולל מיסים ועמלות. הדוגמה הזו מציינת שהייה שאפשר לבטל ללא חיובים עד 23:00 (שעון UTC) בתאריך 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 יכול להכיל מערך של מבצעים.
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 ב- של שירות מתקנים.

דוגמאות

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 בחדר עם 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)

הנכס הזה משמש להוספת הערות לשירותים ספציפיים לתעריף שמסופקים על ידי המלון או חדר, כגון אפשרויות הארוחה ושירות החניית רכבים. אפשר להוסיף הערות 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:00 עד 22:00 ואין מכון כושר זמין במקום. העישון אסור בחדר במלון ויש בו מיני-בר.

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