ویژگی های نشانه گذاری محتوا در رویدادهای تلویزیونی زنده

این بخش جزئیات ویژگی های نشانه گذاری محتوا را برای نوع موجودیت BroadcastEvent ارائه می دهد. برای درک بهتر رابطه بین این انواع، مفاهیم LiveTV Events را مرور کنید.

جدول مشخصات BroadcastEvent

ویژگی نوع مورد انتظار شرح
@context متن الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}] تنظیم شود
  • xx با کد زبان موجودیت در قالب BCP 47 ، به عنوان مثال، "en" جایگزین کنید.
@type متن مورد نیاز - همیشه روی BroadcastEvent تنظیم شود.
@id URL مورد نیاز - شناسه محتوا در قالب URI. برای مثال، https://example.com/1234abc .
@id باید شرایط زیر را داشته باشد:
  • در سراسر کاتالوگ شما منحصر به فرد است
  • استاتیک؛ شناسه باید پایدار باشد و در طول زمان تغییر نکند (حتی اگر ویژگی url نمایش تغییر کند). به عنوان یک رشته مات در نظر گرفته می شود و لازم نیست یک پیوند کاری باشد.
  • در قالب شناسه منبع یکپارچه (URI)
  • دامنه استفاده شده برای مقدار 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
  • broadcastOfEvent
  • contentToBeAnnounced روی true تنظیم شد
  • offAir روی true تنظیم شد
workPerformed.@type متن روی Movie , TVSeries , یا TVEpisode تنظیم کنید .
workPerformed.@id URL @id @ موجودیت محتوا.
broadcastOfEvent رویداد ورزشی در صورت وجود الزامی است - اگر محتوا یک رویداد زنده است از این ویژگی استفاده کنید:
  • برای یک رویداد ورزشی، این ویژگی باید به یک نهاد SportsEvent مراجعه کند.

به شدت توصیه می شود که یک نهاد BroadcastEvent حداقل یکی از موارد زیر را شامل شود:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced روی true تنظیم شد
  • offAir روی true تنظیم شد
broadcastOfEvent.@type متن روی SportsEvent تنظیم کنید.
broadcastOfEvent.@id URL @id موجودیت رویداد. موجودیت رویداد باید در فید وجود داشته باشد و @id متفاوت از BroadcastEvent داشته باشد.
location متن یا کشور اگر BroadcastEvent برای یک رویداد ورزشی باشد، یعنی دارای خاصیت broadcastOfEvent باشد - کشوری که می‌توان رویداد ورزشی اصلی را در آن پخش کرد، الزامی است. اگر چندین کشور بتوانند SportsEvent را پخش کنند، این قسمت می‌تواند فهرستی از کشورها باشد.
videoFormat متن بالاترین کیفیت تعریف پشتیبانی شده در این سرویس پخش؛ مثلا،
  • "SD" برای تعریف استاندارد.
  • "HD" برای وضوح بالا.
  • "2K" برای وضوح 2K.
  • "4K" برای وضوح 4K.
  • "8K" برای وضوح 8K.
contentToBeAnnounced بولی در صورت وجود الزامی است - اگر محتوا در زمان ایجاد فید ناشناخته است از این ویژگی استفاده کنید.

زمانی که ارائه‌دهنده اطلاعات به‌روز درباره آنچه پخش می‌شود ندارد، روی true تنظیم کنید، در غیر این صورت false .
به شدت توصیه می شود که یک نهاد BroadcastEvent حداقل یکی از موارد زیر را شامل شود:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced روی true تنظیم شد
  • offAir روی true تنظیم شد
offAir بولی در صورت وجود الزامی است - اگر محتوای برنامه‌ریزی‌شده‌ای برای مدت زمان پخش وجود ندارد، از این ویژگی استفاده کنید.
به شدت توصیه می شود که یک نهاد BroadcastEvent حداقل یکی از موارد زیر را شامل شود:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced روی true تنظیم شد
  • offAir روی true تنظیم شد
isLiveBroadcast بولی اگر این رویداد زنده است روی true تنظیم کنید. به عنوان مثال، یک رویداد ورزشی یا یک کنسرت.
potentialAction WatchAction در صورت وجود الزامی است - اگر محتوا به‌عنوان یک رویداد پخش زنده کمتر از کانال پخش می‌شود (با contentToBeAnnounced روی false یا offAir روی false تنظیم شده است)، از این ویژگی برای ارائه پیوند عمیق رویداد استفاده کنید.
identifier PropertyValue شناسه خارجی که محتوای پخش شده را شناسایی می کند. برای جزئیات بیشتر به بخش خصوصیات شناسه مراجعه کنید.
  • توجه: نوع نهاد BroadcastEvent فقط مقادیر propertyID ویژگی TMS_ID یا TMS_ROOT_ID را می‌پذیرد.
  • این ویژگی فقط باید برای مواردی ارائه شود که یک موجودیت کاملاً تشکیل‌شده Movie ، TVSeries ، TVEpisode یا SportsEvent با استفاده از ویژگی workPerformed یا broadcastOfEvent ارجاع داده نمی‌شود.
  • مقدار ویژگی باید نشان دهنده TMS_ID یا TMS_ROOT_ID Movie ، TVSeries ، TVEpisode یا SportsEvent باشد که در حالت ایده‌آل با استفاده از ویژگی workPerformed یا broadcastOfEvent به آن ارجاع می‌دهید.
  • TMS_ID بر مقدار TMS_ROOT_ID ترجیح داده می شود.
contentRating متن یا رتبه برای محتوای بزرگسالان مورد نیاز است، به شدت توصیه می شود در غیر این صورت چرا؟ - رتبه بندی کلی محتوای محتوای پخش شده. اگر رتبه بندی محتوا در قالب یک رشته متن داده شود، دو تغییر پذیرفته می شود:
  • آژانس رتبه‌بندی با یک فضای خالی در بین آن رتبه‌بندی را نشان می‌دهد. به عنوان مثال، رتبه بندی "PG-13" از آژانس "MPAA" در ایالات متحده باید به عنوان "MPAA PG-13" توصیف شود. لیست نمایندگی ها را ببینید.
  • مقدار "RATING NOT KNOWN" (بدون حساس به حروف بزرگ) که نشان می دهد رتبه بندی فیلم را نمی دانید.
contentRating.author متن یا سازمان اگر contentRating از Rating استفاده می کند - نام آژانس رتبه بندی الزامی است .
contentRating.ratingValue متن اگر contentRating Rating از 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"
        }
      ]
    }
  }
}

برای موضوعات مرتبط با این خواص، صفحات زیر را بررسی کنید: