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

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

جدول مشخصات BroadcastEvent

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

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

اکیداً توصیه می‌شود که یک موجودیت BroadcastEvent حداقل یکی از موارد زیر را شامل شود:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced روی true تنظیم شده باشد
  • تنظیم offAir روی true
broadcastOfEvent.@type متن روی SportsEvent تنظیم کنید.
broadcastOfEvent.@id آدرس اینترنتی @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 بولی در صورت لزوم - در صورتی که هیچ محتوایی برای پخش در بازه زمانی مورد نظر برنامه‌ریزی نشده باشد، از این ویژگی استفاده کنید.
اکیداً توصیه می‌شود که یک موجودیت BroadcastEvent حداقل یکی از موارد زیر را شامل شود:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced روی true تنظیم شده باشد
  • تنظیم offAir روی true
isLiveBroadcast بولی اگر این یک رویداد زنده است، مثلاً یک رویداد ورزشی یا یک کنسرت، روی true تنظیم شود.
potentialAction تماشا کنید در صورت لزوم - اگر محتوا به عنوان یک رویداد پخش زنده بدون کانال پخش می‌شود (با مقدار false برای contentToBeAnnounced یا مقدار false برای offAir )، از این ویژگی برای ارائه لینک عمیق رویداد استفاده کنید.
identifier ارزش ملک شناسه خارجی که محتوای پخش را مشخص می‌کند. برای جزئیات بیشتر به بخش ویژگی‌های شناسه مراجعه کنید.
  • توجه: نوع موجودیت 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 ) بین ساعت 9 شب تا 9:30 شب در تاریخ 12 اکتبر 2019 پخش می‌شود:

پخش رویداد

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

پخش رویداد

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

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

پخش رویداد

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

برای مباحث مربوط به این املاک، صفحات زیر را بررسی کنید: