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

يقدّم هذا القسم تفاصيل عن سمات ترميز المحتوى الخاصة بنوع الكيان 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 مطلوب إذا كان location @type هو Place - عنوان الموقع الجغرافي. لا يجب استخدام هذه السمة إذا كان location @type هو المدينة.
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 مطلوب إذا كان location @type هو Place - عنوان الموقع الجغرافي. لا يجب استخدام هذا الحقل إذا كان location @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 مطلوب إذا كان location @type هو Place - عنوان الموقع الجغرافي. يجب عدم استخدام هذا الحقل إذا كان location @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 عمل تم أداؤه في فعالية ما، مثل مسرحية تم أداؤها في "فعالية المسرح"

مثال على حدث

حدث 

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