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

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

جدول مشخصات BroadcastEvent

دارایی نوع موردانتظار شرح
@context نوشتار الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}]
    تنظیم شده است
  • xx را با کد زبان نهاد در قالب BCP 47 جایگزین کنید، برای مثال، «en».
@type نوشتار الزامی - همیشه روی BroadcastEvent تنظیم شده است.
@id نشانی وب الزامی - شناسه جایگاه پخش در قالب URI؛ برای مثال، https://example.com/live/channel1/20191012T2100.
@id باید شرایط زیر را داشته باشد:
  • در سراسر کاتالوگ شما به‌طور جهانی منحصربه‌فرد باشد و با workPerformed.@id یا broadcastOfEvent.@id متمایز باشد (برای مثال، کانال/سرویس و زمان شروع پخش را در URI بگنجانید)
  • ایستا؛ شناسه باید ثابت باشد و درطول زمان تغییر نکند. این رشته به‌عنوان رشته‌ای مبهم درنظر گرفته می‌شود و لازم نیست پیوندی فعال باشد.
  • در قالب «شناسه منبع یکسان» (URI)
  • دامنه استفاده‌شده برای مقدار @id باید متعلق به سازمان شما باشد.
مهم: ویژگی url را در BroadcastEvent یا SportsEvent نگنجانید. url متعارف را فقط در نهاد محتوای زیربنایی (Movie، TVSeries، یا TVEpisode) ارائه دهید. برای جزئیات بیشتر، به بخش شناسه مراجعه کنید.
name نوشتار الزامی - عنوان نمایش یا رویداد.
description نوشتار شرح نمایش یا رویداد. حد ۳۰۰ نویسه. از آرایه برای گنجاندن شرح به چند زبان (یک شرح برای هر زبان) استفاده کنید.
startDate تاریخ الزامی - زمان شروع رویداد در قالب ISO 8601 با منطقه زمانی.
endDate تاریخ زمان پایان رویداد در قالب ISO 8601 با منطقه زمانی.
publishedOn BroadcastService درصورت وجود الزامی است - BroadcastService نهادی را که این نمایش یا رویداد را پخش می‌کند مشخص کنید.

اگر محتوا در کانال تلویزیونی پخش می‌شود، این ویژگی الزامی است. اگر محتوا با هیچ کانال تلویزیونی مرتبط نیست، این ویژگی را ارائه نکنید.
publishedOn.@type نوشتار روی BroadcastService تنظیم شده است.
publishedOn.@id نشانی وب @id نهاد BroadcastService که این نمایش یا رویداد را پخش می‌کند.
workPerformed CreativeWork درصورت وجود الزامی است - وقتی محتوا یکی از انواع نهادهای زیر است، از این ویژگی استفاده کنید: Movie، TVSeries، و TVEpisode.
اکیداً توصیه می‌شود که نهاد BroadcastEvent حداقل یکی از موارد زیر را داشته باشد:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced روی true تنظیم شد
  • offAir روی true تنظیم شد
workPerformed.@type نوشتار روی Movie،‏ TVSeries، یا TVEpisode تنظیم شده باشد.
workPerformed.@id نشانی وب @id نهاد محتوا.
broadcastOfEvent SportsEvent درصورت لزوم الزامی است - اگر محتوا رویداد زنده است، از این ویژگی استفاده کنید:
  • برای رویداد ورزشی، این ویژگی باید به نهاد SportsEvent ارجاع دهد.

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

وقتی ارائه‌دهنده اطلاعات به‌روزی درباره آنچه پخش خواهد شد ندارد، روی true تنظیم کنید، درغیراین‌صورت روی false تنظیم کنید.
اکیداً توصیه می‌شود که نهاد BroadcastEvent حداقل یکی از موارد زیر را داشته باشد:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced روی true تنظیم شد
  • offAir روی true تنظیم شد
offAir بولی درصورت وجود الزامی است - وقتی پخش محتوای برنامه‌ریزی‌شده‌ای برای وقت اختصاصی در کانال BroadcastService وجود ندارد، روی true تنظیم می‌شود.
  • هر دو name و description را روی "Off Air" تنظیم کنید.
  • هر offAir BroadcastEvent باید ۴ ساعت یا کمتر باشد (بلوک‌های مداوم ۲۴ ساعته منتشر نکنید). وقتی کانالی بیش‌از ۴ ساعت پخش ندارد، چندین نهاد BroadcastEvent متوالی و غیرهم‌پوشان که هرکدام حداکثر ۴ ساعت باشند منتشر کنید تا کانال پوشش زمان‌بندی کامل ۲۴ ساعته در ۷ روز هفته را بدون هیچ وقفه‌ای در شروع یا پایان پنجره فید حفظ کند.
اکیداً توصیه می‌شود که نهاد BroadcastEvent حداقل یکی از موارد زیر را داشته باشد:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced روی true تنظیم شد
  • offAir روی true تنظیم شد
isLiveBroadcast بولی اگر این پخش یک همه‌فرستی زنده است (برای مثال، یک بازی ورزشی زنده یا اخبار روزانه زنده)، آن را روی مقدار بولی true (بدون علامت نقل‌قول) تنظیم کنید، یا برای برنامه‌های غیرزنده و بازپخش‌ها روی false تنظیم کنید.
potentialAction WatchAction درصورت وجود الزامی است - هرگز potentialAction را در BroadcastEvent ارائه نکنید وقتی broadcastOfEvent به SportsEvent ارجاع می‌دهد (همه پیوندهای عمیق ورزشی را در SportsEvent.potentialAction قرار دهید) یا وقتی publishedOn به کانال BroadcastService ارجاع می‌دهد (پیوندهای عمیق کانال را در BroadcastService.potentialAction قرار دهید). فقط BroadcastEvent.potentialAction را برای جاری‌سازی‌های زنده بدون کانال که به SportsEvent ارجاع نمی‌دهند ارائه کنید (مانند محتوای حاشیه‌ای زنده مستقل با contentToBeAnnounced و 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 استفاده می‌کند، الزامی است - مقدار رده‌بندی.
contentRating.advisoryCode نوشتار کد توصیه محتوایی برای محتوا. مقادیر پذیرفته‌شده شامل D،‏ FV،‏ L،‏ S، و V می‌شود. D = گفتگو، FV = خشونت تخیلی، L = زبان، S = محتوای جنسی، V = خشونت.

مثال‌ها

قسمتی از یک برنامه تلویزیونی در شبکه تلویزیونی Example TV (BroadcastService) بین ساعت ۹ تا ۹:۳۰ بعدازظهر در تاریخ ۱۲ اکتبر ۲۰۱۹ پخش می‌شود:

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

BroadcastService

{
  "@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) بین ساعت ۹ تا ۹:۳۰ بعدازظهر در ۱۲ اکتبر ۲۰۱۹ پخش شود در زمان ایجاد فید مشخص نیست:

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "Content To Be Announced",
  "description": "Content 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
}

BroadcastService

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

شبکه تلویزیونی Example TV (BroadcastService) بین ساعت ۱۲ ظهر تا ۸ شب پخش ندارد (به‌صورت دو بلوک ۴ ساعته متوالی Off Air مدل‌سازی شده است) و بین ساعت ۸ شب تا ۱۲ نیمه‌شب یک نمایش به‌نام My favorite show پخش می‌کند:

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId1",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T12:00-08:00",
  "endDate": "2019-10-12T16: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",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T16: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/randomUniqueEventId3",
  "name": "My favorite show",
  "description": "Evening broadcast of My favorite show.",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/tv_series/my_favorite_show"
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  }
}

BroadcastService

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

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