این بخش جزئیات ویژگیهای نشانهگذاری محتوا را برای نوع موجودیت مرتبط Event ارائه میدهد.
جدول مشخصات SportsEvent
| دارایی | نوع موردانتظار | شرح |
|---|---|---|
@context |
نوشتار | الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}]
|
@type |
نوشتار | الزامی - همیشه روی SportsEvent تنظیم شده است. |
@id |
نشانی وب | الزامی - شناسه محتوا در قالب URI؛ برای مثال، https://example.com/1234abc.@id باید شرایط زیر را داشته باشد:
url را در SportsEvent یا BroadcastEvent نگنجانید. پیوندهای بازپخش را بااستفاده از SportsEvent.potentialAction ارائه دهید. برای جزئیات بیشتر، بخش شناسه را ببینید. |
name |
نوشتار | الزامی - نام این رویداد.
|
description |
نوشتار | شرح این رویداد. حد ۳۰۰ نویسه. از آرایه برای گنجاندن شرح به چند زبان (یک شرح برای هر زبان) استفاده کنید. |
sport |
نشانی وب | الزامی پیوند به صفحه ویکیپدیا (ترجیحاً نسخه انگلیسی) آن ورزش. |
startDate |
DateTime یا Date | الزامی - زمان شروع رویداد در قالب ISO 8601 با منطقه زمانی. لطفاً توجه داشته باشید که این زمان شروع واقعی رویداد است، نه زمانی که رویداد در تلویزیون پخش میشود. |
endDate |
DateTime یا Date | توصیهشده - زمان پایان زمانبندیشده رویداد در قالب ISO 8601 با منطقه زمانی. هرگاه زمان پایان برنامهریزیشده مشخص بود، آن را ارائه دهید؛ اگر زمان پایان مشخص نیست، این ویژگی را حذف کنید و از جایبان تخمینی استفاده نکنید. |
homeTeam |
SportsTeam | بسیار توصیه میشود چرا؟ تیم میزبان رویداد. |
homeTeam.name |
نوشتار | الزامی نام کامل تیم ورزشی. |
homeTeam.sport |
نشانی وب | الزامی پیوند به صفحه ویکیپدیا (ترجیحاً نسخه انگلیسی) آن ورزش. |
homeTeam.sameAs |
نشانی وب | بسیار توصیه میشود چرا؟ نشانی وب صفحه وب مرجعی که بتواند تیم را شناسایی کند؛ برای مثال، صفحه ویکیپدیا تیم. |
homeTeam.athlete |
شخص | حاشیهنویسی(ها) برای یک ورزشکار خاص در تیم. |
homeTeam.athlete.name |
نوشتار | نام کامل ورزشکار. |
homeTeam.parentOrganization |
SportsOrganization | الزامی - لیگ ورزشی یا سازمان حاکمی که تیم به آن تعلق دارد. وقتی هر دو تیم ارائه شدهاند، parentOrganization را در هر دو homeTeam و awayTeam بگنجانید. |
homeTeam.parentOrganization.name |
نوشتار | الزامی - نام لیگ ورزشی که تیم عضو آن است. برای مثال، «اتحادیه ملی بسکتبال» یا «لیگ برتر بیسبال». توجه داشته باشید که از این فیلد نباید برای کنفرانس تیم استفاده شود. |
homeTeam.parentOrganization.sameAs |
نشانی وب | بسیار توصیه میشود چرا؟ - پیوندی به صفحه ویکیپدیا (ترجیحاً نسخه انگلیسی) که لیگ تیم را مشخص میکند (برای مثال، https://en.wikipedia.org/wiki/National_Basketball_Association). از نشانیهای وب جایبان example.com استفاده نکنید. |
awayTeam |
SportsTeam | بسیار توصیه میشود چرا؟ - تیم مهمان رویداد. ویژگیها و الزامات (ازجمله parentOrganization) همانند SportsEvent.homeTeam است. |
competitor |
SportsTeam یا Person | بسیار توصیه میشود چرا؟ اگر تیم میزبان یا مهمان قابلاعمال نیست (مثلاً مسابقه بوکس، المپیک)، شرکتکنندگان را بهعنوان رقیب مشخص کنید. اگر SportsTeam، مشخصات با SportsEvent.homeTeam یکسان است. اگر Person، ویژگیها همانند دیگر اشیاء Person است؛ برای مثال، بازیگر در Movie. |
location |
مکان یا شهر | مکان رویداد. |
location.name |
نوشتار | الزامی - نام مکان. |
location.address |
PostalAddress | اگر @type مکان «مکان» باشد، الزامی است - نشانی مکان. اگر @type مکان «شهر» باشد، نباید از این استفاده شود |
location.address.streetAddress |
نوشتار | نشانی خیابان مکان. |
location.address.addressLocality |
نوشتار | شهر مکان. |
location.address.addressRegion |
نوشتار | وضعیت مکان. |
location.address.postalCode |
نوشتار | کد پستی مکان. |
location.address.addressCountry |
نوشتار | کشورها در قالب 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 |
نوشتار | الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}]
|
@type |
نوشتار | الزامی - همیشه روی MusicEvent تنظیم شده است. |
@id |
نشانی وب | الزامی - شناسه محتوا در قالب URI؛ برای مثال، https://example.com/1234abc.@id باید شرایط زیر را داشته باشد:
url نهاد همه الزامات شناسه را برآورده میکند، توصیه میکنیم از url نهاد بهعنوان @id استفاده کنید. برای جزئیات بیشتر، بخش شناسه را ببینید. |
name |
نوشتار | الزامی - نام این رویداد.
|
description |
نوشتار | شرح رویداد. محدودیت ۳۰۰ نویسه. از آرایه برای گنجاندن شرحها در چندین زبان و طول استفاده کنید. |
attendee |
Organization یا Person | شخص یا سازمانی که در رویداد شرکت میکند. |
startDate |
تاریخ | الزامی - زمان شروع رویداد در قالب ISO 8601 با منطقه زمانی. |
endDate |
تاریخ | زمان پایان رویداد در قالب ISO 8601 با منطقه زمانی. |
composer |
Organization یا Person | شخص یا سازمانی که قطعه موسیقی را نوشته است، یا آهنگساز اثری است که در رویدادی اجرا شده است. |
performer |
Organization یا Person | الزامی - اجراکننده در رویداد - برای مثال، ارائهدهنده، موسیقیدان، گروه موسیقی، یا بازیگر. |
subEvent |
رویداد | رویدادی که بخشی از این رویداد است. برای مثال، رویداد کنفرانس شامل ارائههای زیادی است که هرکدام از آنها subEvent (زیررویداد) کنفرانس است. |
superEvent |
رویداد | رویدادی که این رویداد بخشی از آن است. برای مثال، مجموعهای از اجراهای موسیقی تکی ممکن است هرکدام یک جشنواره موسیقی را بهعنوان superEvent خود داشته باشند. |
location |
مکان یا شهر | الزامی - مکان رویداد. |
location.name |
نوشتار | الزامی - نام مکان. |
location.address |
PostalAddress | اگر @type مکان «مکان» باشد، الزامی است - نشانی مکان. اگر @type مکان «شهر» باشد، نباید از این استفاده شود. |
location.address.streetAddress |
نوشتار | نشانی خیابان مکان. |
location.address.addressLocality |
نوشتار | شهر مکان. |
location.address.addressRegion |
نوشتار | وضعیت مکان. |
location.address.postalCode |
نوشتار | کد پستی مکان. |
location.address.addressCountry |
نوشتار | کشورها در قالب 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 |
نوشتار | الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}]
|
@type |
نوشتار | الزامی - همیشه روی Event تنظیم شده است. |
@id |
نشانی وب | الزامی - شناسه محتوا در قالب URI؛ برای مثال، https://example.com/1234abc.@id باید شرایط زیر را داشته باشد:
url نهاد همه الزامات شناسه را برآورده میکند، توصیه میکنیم از url نهاد بهعنوان @id استفاده کنید. برای جزئیات بیشتر، بخش شناسه را ببینید. |
name |
نوشتار | الزامی - نام این رویداد.
|
description |
نوشتار | شرح رویداد. محدودیت ۳۰۰ نویسه. از آرایه برای گنجاندن شرحها در چندین زبان و طول استفاده کنید. |
attendee |
Organization یا Person | شخص یا سازمانی که در رویداد شرکت میکند. |
startDate |
تاریخ | الزامی - زمان شروع رویداد در قالب ISO 8601 با منطقه زمانی. |
endDate |
تاریخ | زمان پایان رویداد در قالب ISO 8601 با منطقه زمانی. |
subEvent |
رویداد | رویدادی که بخشی از این رویداد است. برای مثال، رویداد کنفرانس شامل ارائههای زیادی است که هرکدام از آنها subEvent (زیررویداد) کنفرانس است. |
superEvent |
رویداد | رویدادی که این رویداد بخشی از آن است. برای مثال، مجموعهای از اجراهای موسیقی تکی ممکن است هرکدام یک جشنواره موسیقی را بهعنوان superEvent خود داشته باشند. |
releasedEvent |
PublicationEvent، FeaturedEvent، یا ExclusiveEvent |
بسیار توصیه میشود چرا؟ - از PublicationEvent برای مشخص کردن انتشار اصلی (جهانی یا محلی) محتوا توسط ناشر استفاده میشود، مانند تاریخ انتشار اصلی فیلم در سینما.علاوهبراین، از FeaturedEvent برای نشان دادن اینکه سرویس شما این محتوا را بهعنوان محتوای اصلی، ویژه، خاص، و غیره بازاریابی میکند استفاده کنید.ExclusiveEvent مشخص میکند که سرویس شما حقوق توزیع انحصاری دارد و شامل مکان و زمان آن میشود.برای جزئیات و مثالها، به بخش مثال مراجعه کنید. |
releasedEvent.@type |
نوشتار | الزامی - حتماً این ویژگی را همیشه روی یکی از موارد زیر تنظیم کنید:
|
releasedEvent.location |
کشور | الزامی - مناطقی که با این رویداد مرتبط هستند. برای PublicationEvent، این منطقهای است که محتوا در آن منتشر شده است.برای FeaturedEvent و ExclusiveEvent، این منطقهای است که محتوا در آن ویژه یا انحصاری است.از کدهای ISO 3166 برای کشورها استفاده کنید. برای نشان دادن همه جای دنیا، روی EARTH تنظیم کنید. |
releasedEvent.startDate |
تاریخ یا DateTime | توصیهشده - برای ExclusiveEvent الزامی است - تاریخ شروع انتشار نهاد.برای PublicationEvent، این تاریخ نشاندهنده تاریخ انتشار اولیه این نهاد است، مثلاً تاریخی که فیلم برای اولینبار در سینماها اکران شده است.برای ExclusiveEvent و FeaturedEvent، این تاریخ نشاندهنده تاریخ شروع زمانی است که نهاد انحصاری یا ویژه است. |
releasedEvent.endDate |
Date یا DateTime | توصیهشده - برای ExclusiveEvent الزامی است - این فقط برای انواع ExclusiveEvent و FeaturedEvent قابلاجرا است.برای ExclusiveEvent، این نشاندهنده تاریخی است که حقوق محتوا منقضی میشود.برای FeaturedEvent، این نشاندهنده آخرین تاریخی است که ارائهدهنده نهاد را نمایش میدهد.اگر محتوا بهطور دائمی انحصاری یا ویژه است، endDate را روی ۲۰ سال از تاریخ فعلی تنظیم کنید. |
releasedEvent.publishedBy |
Organization یا Person | اختیاری - سازمان یا شخصی که این نهاد را منتشر کرده است. |
location |
مکان یا شهر | الزامی - مکان رویداد. توجه داشته باشید که میتوانید Place را در سطح City ارائه دهید. |
location.name |
نوشتار | الزامی - نام مکان. |
location.address |
PostalAddress | اگر @type مکان «مکان» باشد، الزامی است - نشانی مکان. اگر @type مکان «شهر» باشد، نباید از این استفاده شود |
location.address.streetAddress |
نوشتار | نشانی خیابان مکان. |
location.address.addressLocality |
نوشتار | شهر مکان. |
location.address.addressRegion |
نوشتار | وضعیت مکان. |
location.address.postalCode |
نوشتار | کد پستی مکان. |
location.address.addressCountry |
نوشتار | کشورها در قالب 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"
}
}