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

این بخش جزئیات ویژگی‌های نشانه‌گذاری محتوا را برای نوع موجودیت 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 مربوطه می‌تواند در آن پخش شود. باید کد کشور ISO 3166-1 alpha-2 با حروف بزرگ باشد (برای مثال، "US" یا "CA")، چه به‌عنوان Text ارائه شده باشد یا در ویژگی name شیء Country. برای فهرست کردن چند کشور، از آرایه استفاده کنید.
مثال: "location": "US" یا "location": {"@type": "Country", "name": "US"}
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"
        }
      ]
    }
  }
}

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