يقدّم هذا القسم تفاصيل سمات ترميز المحتوى لنوع الكيان المرتبط بـ Event.
جدول مواصفات SportsEvent
| الموقع | النوع المتوقّع | الوصف |
|---|---|---|
@context |
Text | مطلوب: يجب ضبطه دائمًا على ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | مطلوبة: يجب ضبطها دائمًا على SportsEvent. |
@id |
URL | مطلوب: معرّف المحتوى بتنسيق معرّف الموارد المنتظم (URI)، مثلاً https://example.com/1234abc.@id يجب أن يستوفي المتطلبات التالية:
url في SportsEvent أو BroadcastEvent. يجب تقديم روابط تشغيل باستخدام SportsEvent.potentialAction. يمكنك الاطّلاع على قسم المعرّف لمزيد من التفاصيل. |
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 |
SportsOrganization | مطلوب: الدوري الرياضي أو المؤسسة الإدارية التي ينتمي إليها الفريق. يجب تضمين parentOrganization في كل من homeTeam وawayTeam عند تقديم كلا الفريقين. |
homeTeam.parentOrganization.name |
Text | مطلوبة: اسم الدوري الرياضي الذي يشارك فيه الفريق. على سبيل المثال، الرابطة الوطنية لكرة السلة أو دوري البيسبول الرئيسي. يُرجى العِلم أنّه يجب عدم استخدام هذا الحقل لمؤتمر الفريق. |
homeTeam.parentOrganization.sameAs |
URL | ننصح به بشدة السبب - رابط يؤدي إلى صفحة Wikipedia (يُفضَّل استخدام النسخة الإنجليزية) التي تحدّد دوري الفريق (مثلاً، https://en.wikipedia.org/wiki/National_Basketball_Association). لا تستخدِم عناوين URL نائبة من example.com. |
awayTeam |
SportsTeam | ننصح به بشدة السبب - الفريق الضيف في الحدث السمات والمتطلبات (بما في ذلك parentOrganization) هي نفسها لـ 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 | مطلوبة إذا كانت منطبقة: روابط لصفحات معيّنة لتشغيل الحدث الرياضي، وتُستخدَم لكل من أحداث البث المباشر غير المرتبطة بقناة وعمليات إعادة تشغيل الفيديو عند الطلب. يجب أن تكون جميع الروابط لصفحات معيّنة في الأحداث الرياضية متوفّرة في SportsEvent.potentialAction. لا تضع أبدًا potentialAction في BroadcastEvent يشير إلى SportsEvent (بالنسبة إلى عمليات البث على قنوات تلفزيونية مُجدوَلة بدون رابط مباشر لصفحة معيّنة في الحدث، قدِّم الرابط لصفحة معيّنة في القناة على BroadcastService.potentialAction). قدِّم مصفوفة من عناصر WatchAction عند تقديم أحداث بث متعددة (مثل الخلاصة الإقليمية أو خلاصة الفريق المضيف أو الضيف أو عمليات البث المتعددة اللغات) أو نوافذ إعادة تشغيل منفصلة للبث المباشر والفيديو عند الطلب. |
potentialAction.actionAccessibilityRequirement |
ActionAccessSpecification | مطلوبة في حال توفّر السمة potentialAction: تحدّد هذه السمة نافذة مدى التوفر القابلة للنقر والوصول إلى المحتوى (availabilityStarts وavailabilityEnds) لكل WatchAction:
|
identifier |
PropertyValue | ننصح به بشدة السبب - المعرّف الخارجي أو المعرّف الآخر الذي يعرّف هذا الكيان بوضوح ويُسمح باستخدام عدّة معرّفات. يُرجى الاطّلاع على قسم سمات المعرّفات للحصول على التفاصيل. |
أمثلة على SportsEvent
مثال على رياضة جماعية
{
"@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": "es",
"@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
}
],
"startDate": "2019-09-16T21:10-08:00",
"endDate": "2019-09-17T00:00-08:00",
"homeTeam": {
"@type": "SportsTeam",
"name": "Team B",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"athlete": [
{
"@type": "Person",
"name": "John Doe"
}
]
},
"awayTeam": {
"@type": "SportsTeam",
"name": "Team A",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"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": "EP000194303282"
}
]
}
مثال على الرياضات الفردية
{
"@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",
"endDate": "2019-07-12T23:30-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"
}
}
}
SportsEvent مع قيود GeoShape
{
"@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": "es",
"@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
}
],
"startDate": "2019-09-16T21:10-08:00",
"endDate": "2019-09-17T00:00-08:00",
"homeTeam": {
"@type": "SportsTeam",
"name": "Team B",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"athlete": [
{
"@type": "Person",
"name": "John Doe"
}
]
},
"awayTeam": {
"@type": "SportsTeam",
"name": "Team A",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"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": "EP000194303282"
}
],
"potentialAction": [
{
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "free",
"availabilityStarts": "2019-09-01T10:35:29Z",
"availabilityEnds": "2019-09-17T11:00:00Z",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
},
{
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
"inLanguage": "en",
"actionPlatform": "http://schema.org/AndroidTVPlatform"
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"availabilityStarts": "2019-09-01T10:35:29Z",
"availabilityEnds": "2019-09-17T11:00:00Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "http://www.example.com/example_package"
},
"eligibleRegion": [
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
},
{
"@type": "GeoShape",
"@id": "http://example.com/area2",
"addressCountry": "US",
"postalCode": [
"94120",
"94121"
]
}
]
}
}
]
}
جدول مواصفات MusicEvent
| الموقع | النوع المتوقّع | الوصف |
|---|---|---|
@context |
Text | مطلوبة: يجب ضبطها دائمًا على ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | مطلوبة: يجب ضبطها دائمًا على MusicEvent. |
@id |
URL | مطلوب: معرّف المحتوى بتنسيق معرّف الموارد المنتظم (URI)، مثلاً https://example.com/1234abc.@id يجب أن يستوفي المتطلبات التالية:
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 للموقع الجغرافي هو 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 | عمل يتم تنفيذه في فعالية معيّنة، مثل مسرحية يتم عرضها في TheaterEvent |
مثال على 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"}]
|
@type |
Text | مطلوبة: يجب ضبطها دائمًا على Event. |
@id |
URL | مطلوب: معرّف المحتوى بتنسيق معرّف الموارد المنتظم (URI)، مثلاً https://example.com/1234abc.@id يجب أن يستوفي المتطلبات التالية:
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 | مطلوبة: احرص دائمًا على ضبط هذه السمة على إحدى القيم التالية:
|
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 | عمل يتم تنفيذه في فعالية معيّنة، مثل مسرحية يتم عرضها في TheaterEvent |
مثال على حدث
الحدث
{
"@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"
}
}