این بخش جزئیات ویژگی های نشانه گذاری محتوا را برای نوع موجودیت BroadcastEvent
ارائه می دهد. برای درک بهتر رابطه بین این انواع، مفاهیم LiveTV Events را مرور کنید.
جدول مشخصات BroadcastEvent
ویژگی | نوع مورد انتظار | شرح |
---|---|---|
@context | متن | الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}] تنظیم شود
|
@type | متن | مورد نیاز - همیشه روی BroadcastEvent تنظیم شود. |
@id | URL | مورد نیاز - شناسه محتوا در قالب URI. برای مثال، https://example.com/1234abc .@id باید شرایط زیر را داشته باشد:
url یک موجودیت همه الزامات را به عنوان یک شناسه برآورده میکند، توصیه میکنیم url موجودیت بهعنوان @id استفاده کنید. برای جزئیات بیشتر به بخش شناسه مراجعه کنید. |
name | متن | مورد نیاز - عنوان نمایش یا رویداد. |
description | متن | شرح نمایش یا رویداد. لیست 300 کاراکتری. از یک آرایه برای گنجاندن توضیحات در چندین زبان و طول استفاده کنید. |
startDate | تاریخ | مورد نیاز - زمان شروع رویداد در قالب ISO 8601 با منطقه زمانی. |
endDate | تاریخ | زمان پایان رویداد در قالب ISO 8601 با منطقه زمانی. |
publishedOn | سرویس پخش | در صورت وجود الزامی است - نهاد BroadcastService را که این نمایش یا رویداد را پخش می کند، مشخص کنید.اگر محتوا در یک کانال تلویزیونی پخش می شود، این ویژگی الزامی است. اگر محتوا با هیچ کانال تلویزیونی مرتبط نیست، این ویژگی را ارائه ندهید. |
publishedOn.@type | متن | روی BroadcastService تنظیم کنید. |
publishedOn.@id | URL | @id موجودیت BroadcastService که این نمایش یا رویداد را پخش میکند. |
workPerformed | کار خلاقانه | در صورت وجود الزامی است - وقتی محتوا یکی از انواع موجودیت زیر است از این ویژگی استفاده کنید: Movie ، TVSeries ، و TVEpisode .به شدت توصیه می شود که یک نهاد BroadcastEvent حداقل یکی از موارد زیر را شامل شود:
|
workPerformed.@type | متن | روی Movie , TVSeries , یا TVEpisode تنظیم کنید . |
workPerformed.@id | URL | @id موجودیت محتوا. |
broadcastOfEvent | رویداد ورزشی | در صورت وجود الزامی است - اگر محتوا یک رویداد زنده است از این ویژگی استفاده کنید:
به شدت توصیه می شود که یک نهاد BroadcastEvent حداقل یکی از موارد زیر را شامل شود:
|
broadcastOfEvent.@type | متن | روی SportsEvent تنظیم کنید. |
broadcastOfEvent.@id | URL | @id موجودیت رویداد. موجودیت رویداد باید در فید وجود داشته باشد و @id متفاوت از BroadcastEvent داشته باشد. |
location | متن یا کشور | اگر BroadcastEvent برای یک رویداد ورزشی باشد، یعنی دارای خاصیت broadcastOfEvent باشد - کشوری که میتوان رویداد ورزشی اصلی را در آن پخش کرد، الزامی است . اگر چندین کشور بتوانند SportsEvent را پخش کنند، این قسمت میتواند فهرستی از کشورها باشد. |
videoFormat | متن | بالاترین کیفیت تعریف پشتیبانی شده در این سرویس پخش؛ مثلا،
|
contentToBeAnnounced | بولی | در صورت وجود الزامی است - اگر محتوا در زمان ایجاد فید ناشناخته است از این ویژگی استفاده کنید. زمانی که ارائهدهنده اطلاعات بهروز درباره آنچه پخش میشود ندارد، روی true تنظیم کنید، در غیر این صورت false .به شدت توصیه می شود که یک نهاد BroadcastEvent حداقل یکی از موارد زیر را شامل شود:
|
offAir | بولی | در صورت وجود الزامی است - اگر محتوای برنامهریزیشدهای برای مدت زمان پخش وجود ندارد، از این ویژگی استفاده کنید. به شدت توصیه می شود که یک نهاد BroadcastEvent حداقل یکی از موارد زیر را شامل شود:
|
isLiveBroadcast | بولی | اگر این رویداد زنده است روی true تنظیم کنید. به عنوان مثال، یک رویداد ورزشی یا یک کنسرت. |
potentialAction | WatchAction | در صورت وجود الزامی است - اگر محتوا بهعنوان یک رویداد پخش زنده کمتر از کانال پخش میشود (با contentToBeAnnounced روی false یا offAir روی false تنظیم شده است)، از این ویژگی برای ارائه پیوند عمیق رویداد استفاده کنید. |
identifier | PropertyValue | شناسه خارجی که محتوای پخش شده را شناسایی می کند. برای جزئیات بیشتر به بخش خصوصیات شناسه مراجعه کنید.
|
contentRating | متن یا رتبه | برای محتوای بزرگسالان مورد نیاز است، به شدت توصیه می شود در غیر این صورت چرا؟ - رتبه بندی کلی محتوای محتوای پخش شده. اگر رتبه بندی محتوا در قالب یک رشته متن داده شود، دو تغییر پذیرفته می شود:
|
contentRating.author | سازمان | اگر contentRating از Rating استفاده می کند - نام آژانس رتبه بندی الزامی است . |
contentRating.ratingValue | متن | اگر contentRating از Rating استفاده می کند - ارزش رتبه بندی الزامی است . |
contentRating.advisoryCode | متن | کد مشاوره برای محتوا. مقادیر پذیرفته شده عبارتند از D، FV، L، S، و V. D = گفتگو، FV = خشونت فانتزی، L = زبان، S = محتوای جنسی، V = خشونت. |
مثال ها
یک قسمت تلویزیونی از شبکه تلویزیونی Example TV ( BroadcastService
) بین ساعت 9 شب تا 21:30 در تاریخ 12 اکتبر 2019 پخش می شود:
BroadcastEvent
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
"name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
"description": "Three mice leave the town and the trip turns into something more.",
"startDate": "2019-10-12T21:00-08:00",
"endDate": "2019-10-12T21:30-08:00",
"videoFormat": "HD",
"isLiveBroadcast": false,
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"workPerformed": {
"@type": "TVEpisode",
"@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
}
}
سرویس پخش
{
"@context":"http://schema.org",
"@type":"BroadcastService",
"@id":"http://example.com/stations/example_tv",
"name":"EXAMPLE-TV",
"broadcastDisplayName":"ABCD",
"callSign": "EXA-TV",
"videoFormat":"SD",
"broadcastTimezone":"America/Los_Angeles",
"broadcastAffiliateOf":{
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network"
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12258"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-123456"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/livestream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
"identifier": "example.com:basic",
"commonTier": false
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
}
مثالی برای نشان دادن استفاده از ویژگی contentToBeAnnounced
هنگامی که محتوایی که قرار است در شبکه تلویزیونی Example TV ( BroadcastService
) بین ساعت 9 شب تا 9:30 بعد از ظهر در 12 اکتبر 2019 پخش شود، در زمان ایجاد فید مشخص نیست:
BroadcastEvent
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId",
"name": "To Be Announced"
"startDate": "2019-10-12T21:00-08:00",
"endDate": "2019-10-12T21:30-08:00",
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"contentToBeAnnounced": true
}
سرویس پخش
{
"@context":"http://schema.org",
"@type":"BroadcastService",
"@id":"http://example.com/stations/example_tv",
"name":"EXAMPLE-TV",
"broadcastDisplayName":"ABCD",
"callSign": "EXA-TV",
"videoFormat":"SD",
"broadcastTimezone":"America/Los_Angeles",
"broadcastAffiliateOf":{
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network"
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12258"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-123456"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/livestream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
"identifier": "example.com:basic",
"commonTier": false
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
}
شبکه تلویزیونی مثال کانال تلویزیونی ( BroadcastService
) بین ساعت 12 تا 20 خاموش است و 1 برنامه را با نام My favorite show
بین ساعت 20 تا 12 پخش می کند:
BroadcastEvent
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId1",
"name": “Off Air”,
"startDate": "2019-10-12T00:00-08:00",
"endDate": "2019-10-12T20:00-08:00",
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"offAir": true
},
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId2",
"startDate": "2019-10-12T20:00-08:00",
"endDate": "2019-10-13T00:00-08:00",
"videoFormat": "HD",
"isLiveBroadcast": false,
"name": "My favorite show",
"workPerformed": {
...
},
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
}
سرویس پخش
{
"@context":"http://schema.org",
"@type":"BroadcastService",
"@id":"http://example.com/stations/example_tv",
"name":"EXAMPLE-TV",
"broadcastDisplayName":"ABCD",
"callSign": "EXA-TV",
"videoFormat":"SD",
"broadcastTimezone":"America/Los_Angeles",
"broadcastAffiliateOf":{
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network"
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12258"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-123456"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/livestream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
"identifier": "example.com:basic",
"commonTier": false
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
}
صفحات مرتبط
برای موضوعات مرتبط با این خواص، صفحات زیر را بررسی کنید: