خصائص ترميز المحتوى الخاصة بالأحداث

يوفّر هذا القسم تفاصيل سمات تنسيق المحتوى لنوع العنصر Event ذي الصلة.

جدول مواصفات SportsEvent

الموقع النوع المتوقّع الوصف
@context Text مطلوب: يتم ضبطها دائمًا على ["http://schema.org", {"@language": "xx"}]
  • استبدِل xx برمز لغة الكيان بتنسيق BCP 47، على سبيل المثال، "en".
@type Text مطلوبة: يتم ضبطها دائمًا على SportsEvent.
@id URL مطلوبة: معرّف المحتوى بتنسيق معرّف الموارد المنتظم (URI)، على سبيل المثال، https://example.com/1234abc.
@id يجب أن تستوفي المتطلبات التالية:
  • فريد على مستوى العالم في جميع قنوات التسويق
  • ثابتة: يجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت (حتى إذا تغيّرت خاصية url للعرض). وسيتم التعامل معه كسلسلة مبهمة ولا يلزم أن يكون رابطًا منشورًا.
  • في شكل معرّف موارد موحّد (URI)
  • يجب أن يكون النطاق المستخدَم في القيمة @id مملوكًا لمؤسستك.
بما أنّ url للكيان يستوفي جميع المتطلبات كمعرّف، ننصحك باستخدام url للكيان كـ @id. راجِع قسم المعرّف للحصول على مزيد من التفاصيل.
name Text مطلوبة: اسم هذا الحدث.
  • استخدِم صفيفًا لعرض الأسماء بلغات مختلفة. اطّلِع على مثال مناطق ولغات متعدّدة.
  • يُرجى العلم أنّه يمكن استخدام اسم واحد فقط لكل لغة (زوج لغة-بلد).
description Text وصف هذا الحدث الحد الأقصى المسموح به هو 300 حرف. استخدِم صفيفًا لتضمين الأوصاف بلغات وأشكال متعددة.
sport URL مطلوبة: رابط يؤدي إلى صفحة الرياضة في ويكيبيديا (يُفضّل استخدام النسخة الإنجليزية)
startDate DateTime أو Date سمة مطلوبة: وقت بدء الفعالية بتنسيق ISO 8601 مع المنطقة الزمنية يُرجى العِلم أنّ هذا هو وقت بدء الحدث الفعلي، وليس وقت بث الحدث على التلفزيون.
endDate DateTime أو Date وقت انتهاء الفعالية بتنسيق ISO 8601 مع المنطقة الزمنية
homeTeam SportsTeam إجراءات مقترَحة بشدة لماذا؟ الفريق المضيف للفعالية.
homeTeam.name Text مطلوبة: الاسم الكامل للفريق الرياضي.
homeTeam.sport URL مطلوبة: رابط يؤدي إلى صفحة الرياضة في ويكيبيديا (يُفضّل استخدام النسخة الإنجليزية)
homeTeam.sameAs URL إجراء مقترَح بشدة لماذا؟ عنوان URL لصفحة ويب مرجعية يمكنها تحديد الفريق، مثل صفحة الفريق على "ويكيبيديا"
homeTeam.athlete الشخص تعليقات توضيحية لرياضي فردي في الفريق
homeTeam.athlete.name Text الاسم الكامل للرياضي
homeTeam.parentOrganization.name SportsOrganization مطلوبة: اسم الدوري الرياضي الذي ينتمي إليه الفريق. على سبيل المثال، "رابطة كرة السلة الوطنية" أو "دوري البيسبول الأمريكي". يُرجى العلم أنّه يجب عدم استخدام هذا الحقل لمكالمة الفيديو الجماعية للفريق.
homeTeam.parentOrganization.sameAs URL إجراء مقترَح بشدة لماذا؟ عنوان URL لصفحة ويب مرجعية يمكنها تحديد دوري الفريق، مثل صفحة الدوري على "ويكيبيديا"
awayTeam SportsTeam إجراء مقترَح بشدة لماذا؟ الفريق الضيف في الحدث. تكون السمات نفسها مثل SportsEvent.homeTeam.
competitor SportsTeam أو Person إجراءات مقترَحة بشدة لماذا؟ إذا لم يكن الفريق المضيف أو الضيف منطبقًا (مثل مباراة ملاكمة أو دورة أولمبية)، حدِّد المشاركين كمنافسين. إذا كانت القيمة SportsTeam، تكون السمات هي نفسها في SportsEvent.homeTeam. إذا كانت Person، تكون السمات هي نفسها مثل عناصر Person الأخرى، على سبيل المثال، ممثل في Movie.
location مكان أو مدينة الموقع الجغرافي حيث ستقام الفعالية.
location.name Text مطلوبة: اسم الموقع الجغرافي.
location.address PostalAddress مطلوبة إذا كان نوع الموقع الجغرافي هو "مكان": عنوان الموقع الجغرافي. يجب عدم استخدام هذا العنصر إذا كانت قيمة السمة @type للموقع الجغرافي هي City.
location.address.streetAddress Text عنوان الشارع للموقع الجغرافي
location.address.addressLocality Text مدينة الموقع الجغرافي
location.address.addressRegion Text حالة الموقع الجغرافي
location.address.postalCode Text الرمز البريدي للموقع الجغرافي
location.address.addressCountry Text البلدان بتنسيق ISO 3166
image ImageObject مطلوبة لأجهزة Google TV: الصور ذات الصلة بالحدث يُنصح باستخدام الملصق أو بانر العرض الرسميَين للفعالية. لمزيد من التفاصيل حول السمات المطلوبة والاختيارية المطلوب تضمينها مع image، اطّلِع على سمات الصورة.
potentialAction WatchAction مطلوبة إذا أمكن: الرابط لصفحة معيّنة لتشغيل تسجيل هذا الحدث الرياضي على الفيديو عند الطلب لتحديد الرابط لصفحة حدث مباشر، استخدِم السمة publishedOn أو potentialAction في BroadcastEvent بدلاً من ذلك.
identifier PropertyValue إجراءات مقترَحة بشدة لماذا؟ ‫- المعرّف الخارجي أو المعرّف الآخر الذي يعرّف هذا الكيان بوضوح يُسمح باستخدام عدّة معرّفات. راجِع قسم خصائص المعرّف للحصول على التفاصيل.

أمثلة على SportsEvent

مثال 1 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

مثال 2 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "sport":"https://en.wikipedia.org/wiki/Boxing"
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

جدول مواصفات MusicEvent

الموقع النوع المتوقّع الوصف
@context Text مطلوب: يتم ضبطها دائمًا على ["http://schema.org", {"@language": "xx"}]
  • استبدِل xx برمز لغة الكيان بتنسيق BCP 47، على سبيل المثال، "en".
@type Text مطلوبة: يتم ضبطها دائمًا على MusicEvent.
@id URL مطلوبة: معرّف المحتوى بتنسيق معرّف الموارد المنتظم (URI)، على سبيل المثال، https://example.com/1234abc.
@id يجب أن تستوفي المتطلبات التالية:
  • فريد على مستوى العالم في جميع قنوات التسويق
  • ثابت
  • في شكل معرّف موارد موحّد (URI)
بما أنّ url للكيان يستوفي جميع المتطلبات كمعرّف، ننصحك باستخدام url للكيان كـ @id. راجِع قسم المعرّف للحصول على مزيد من التفاصيل.
name Text مطلوبة: اسم هذا الحدث.
  • استخدِم صفيفًا لعرض الأسماء بلغات مختلفة. اطّلِع على مثال مناطق ولغات متعدّدة.
  • يُرجى العلم أنّه يمكن استخدام اسم واحد فقط لكل لغة (زوج لغة-بلد).
description Text وصف الحدث الحد الأقصى المسموح به هو 300 حرف. استخدِم صفيفًا لتضمين الأوصاف بلغات وأشكال متعددة.
attendee Organization أو Person شخص أو مؤسسة يحضران الفعالية
startDate التاريخ مطلوبة: وقت بدء الفعالية بتنسيق ISO 8601 مع المنطقة الزمنية
endDate التاريخ وقت انتهاء الفعالية بتنسيق ISO 8601 مع المنطقة الزمنية
composer Organization أو Person الشخص أو المؤسسة التي كتبت قطعة موسيقية أو هي مؤلفة عمل تم أداؤه في حدث معيّن.
performer Organization أو Person مطلوبة: فنان في الحدث، مثل مقدّم أو موسيقي أو مجموعة موسيقية أو ممثل
subEvent الحدث حدث يمثّل جزءًا من هذا الحدث على سبيل المثال، يتضمّن حدث المؤتمر العديد من العروض التقديمية، وكلّ عرض منها هو حدث فرعي للمؤتمر.
superEvent الحدث حدث هذا الحدث جزء منه. على سبيل المثال، قد يكون لكل عرض موسيقي فردي في مجموعة موسيقية مهرجان موسيقي كحدث ضخم.
location مكان أو مدينة مطلوبة: الموقع الجغرافي للفعالية.
location.name Text مطلوبة: اسم الموقع الجغرافي
location.address PostalAddress مطلوبة إذا كان نوع الموقع الجغرافي هو "مكان": عنوان الموقع الجغرافي. يجب عدم استخدام هذا العنصر إذا كان الموقع الجغرافي @type هو مدينة.
location.address.streetAddress Text عنوان الشارع للموقع الجغرافي
location.address.addressLocality Text مدينة الموقع الجغرافي
location.address.addressRegion Text حالة الموقع الجغرافي
location.address.postalCode Text الرمز البريدي للموقع الجغرافي
location.address.addressCountry Text البلدان بتنسيق ISO 3166
workPerformed CreativeWork عمل يتم أداؤه في حدث معيّن، مثل مسرحية يتم أداؤها في حدث مسرحي

مثال على MusicEvent

MusicEvent 

{
  "@context":"http://schema.org",
  "@type":"MusicEvent",
  "@id": "http://example.com/music/my_favortie_artist/2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
  "startDate": "2014-10-12T21:10-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "performer": {
    "@type":"Person",
    "name":"My Favorite Artist",
    "birthDate":"1977-02-24",
    "gender":"F",
    "nationality":"CA"
  }
}

جدول مواصفات الحدث

الموقع النوع المتوقّع الوصف
@context Text مطلوب: يتم ضبطها دائمًا على ["http://schema.org", {"@language": "xx"}]
  • استبدِل xx برمز لغة الكيان بتنسيق BCP 47، على سبيل المثال، "en".
@type Text مطلوبة: يتم ضبطها دائمًا على Event.
@id URL مطلوبة: معرّف المحتوى بتنسيق معرّف الموارد المنتظم (URI)، على سبيل المثال، https://example.com/1234abc.
@id يجب أن تستوفي المتطلبات التالية:
  • فريد على مستوى العالم في جميع قنوات التسويق
  • ثابت
  • في شكل معرّف موارد موحّد (URI)
بما أنّ url للكيان يستوفي جميع المتطلبات كمعرّف، ننصحك باستخدام url للكيان كـ @id. راجِع قسم المعرّف للحصول على مزيد من التفاصيل.
name Text مطلوبة: اسم هذا الحدث.
  • استخدِم صفيفًا لعرض الأسماء بلغات مختلفة. اطّلِع على مثال مناطق ولغات متعدّدة.
  • يُرجى العلم أنّه يمكن استخدام اسم واحد فقط لكل لغة (زوج لغة-بلد).
description Text وصف الحدث الحد الأقصى المسموح به هو 300 حرف. استخدِم صفيفًا لتضمين الأوصاف بلغات وأشكال متعددة.
attendee Organization أو Person شخص أو مؤسسة يحضران الفعالية
startDate التاريخ مطلوبة: وقت بدء الفعالية بتنسيق ISO 8601 مع المنطقة الزمنية
endDate التاريخ وقت انتهاء الفعالية بتنسيق ISO 8601 مع المنطقة الزمنية
subEvent الحدث حدث يمثّل جزءًا من هذا الحدث على سبيل المثال، يتضمّن حدث المؤتمر العديد من العروض التقديمية، وكلّ عرض منها هو حدث فرعي للمؤتمر.
superEvent الحدث الحدث الذي يمثّل هذا الحدث جزءًا منه. على سبيل المثال، قد يكون لكل عرض موسيقي فردي في مجموعة موسيقية مهرجان موسيقي كحدث ضخم.
releasedEvent PublicationEvent أو FeaturedEvent أو ExclusiveEvent إجراء مقترَح بشدة لماذا؟ - يُستخدَم الرمز PublicationEvent لتحديد تاريخ الإصدار الأصلي (العالمي أو المحلي) للمحتوى من قِبل الناشر، مثل تاريخ الإصدار الأصلي للفيلم في دور العرض.

بالإضافة إلى ذلك، استخدِم الرمز FeaturedEvent للإشارة إلى أنّ خدمتك تسوّق هذا المحتوى على أنّه أصلي أو مميّز أو خاص وما إلى ذلك.

يحدد الرمز ExclusiveEvent أنّ خدمتك تمتلك حقوق التوزيع الحصرية، ويشمل ذلك مكان الإصدار والوقت.

اطّلِع على قسم الأمثلة للاطّلاع على التفاصيل والأمثلة.
releasedEvent.@type Text سمة مطلوبة: احرص على ضبط هذه السمة دائمًا على إحدى القيم التالية:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location البلد سمة مطلوبة: المناطق المرتبطة بهذا الحدث.

بالنسبة إلى PublicationEvent، هذه هي المنطقة التي تم نشر المحتوى فيها.

بالنسبة إلى FeaturedEvent وExclusiveEvent، هذه هي المنطقة التي يكون فيها المحتوى معروضًا أو حصريًا.

استخدِم رموز ISO 3166 للبلدان. للإشارة إلى أي مكان في العالم، اضبط القيمة على EARTH.
releasedEvent.startDate Date أو DateTime مُقترَح - مطلوبة لعنصر ExclusiveEvent: تاريخ بدء نشر العنصر.

بالنسبة إلى عنصر PublicationEvent، يشير ذلك إلى تاريخ الإصدار الأول لهذا العنصر، مثل تاريخ عرض فيلم لأول مرة في دور العرض.

بالنسبة إلى عنصرَي ExclusiveEvent وFeaturedEvent، يشير ذلك إلى تاريخ بدء عرض العنصر حصريًا أو بشكل بارز.
releasedEvent.endDate Date أو DateTime مُستحسَن - سمة مطلوبة لسمة ExclusiveEvent: لا تنطبق هذه السمة إلا على نوعَي المحتوى ExclusiveEvent وFeaturedEvent.

بالنسبة إلى سمة ExclusiveEvent، يمثّل هذا التاريخ تاريخ انتهاء صلاحية حقوق المحتوى.

بالنسبة إلى سمة FeaturedEvent، يمثّل هذا التاريخ آخر تاريخ عرض فيه الموفّر المحتوى.

إذا كان المحتوى حصريًا أو معروضًا بشكل دائم، اضبط سمة endDate على 20 عامًا من التاريخ الحالي.
releasedEvent.publishedBy Organization أو Person اختياري: المؤسسة أو الشخص الذي نشر هذا الكيان.
location مكان أو مدينة مطلوبة: الموقع الجغرافي للفعالية. يُرجى العِلم أنّه يمكنك تقديم Place في مستوى City.
location.name Text مطلوبة: اسم الموقع الجغرافي
location.address PostalAddress مطلوبة إذا كان نوع الموقع الجغرافي هو "مكان": عنوان الموقع الجغرافي. يجب عدم استخدام هذا العنصر إذا كان الموقع الجغرافي @type هو City.
location.address.streetAddress Text عنوان الشارع للموقع الجغرافي
location.address.addressLocality Text مدينة الموقع الجغرافي
location.address.addressRegion Text حالة الموقع الجغرافي
location.address.postalCode Text الرمز البريدي للموقع الجغرافي
location.address.addressCountry Text البلدان بتنسيق ISO 3166
workPerformed CreativeWork عمل يتم أداؤه في حدث معيّن، مثل مسرحية يتم أداؤها في حدث مسرحي

مثال على الحدث

الحدث 

{
  "@context":"http://schema.org",
  "@type":"Event",
  "@id": "http://example.com/keynote/google_io_2019",
  "name":"Google I/O 2019 keynote",
  "description":"Google’s annual developer conference keynote event.",
  "startDate": "2019-05-07T10:00-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "attendee": {
    "@type":"Person",
    "name":"My Favorite Speaker",
    "birthDate":"1971-12-02",
    "gender":"F",
    "nationality":"IN"
  }
}