سمات ترميز المحتوى لأحداث البث التلفزيوني المباشر

يوفّر هذا القسم تفاصيل سمات ترميز المحتوى لنوع الكيان BroadcastEvent. لفهم العلاقة بين هذه الأنواع بشكل أفضل، راجِع مفاهيم أحداث LiveTV.

جدول مواصفات BroadcastEvent

الموقع النوع المتوقّع الوصف
@context Text مطلوبة: يجب ضبطها دائمًا على ["http://schema.org", {"@language": "xx"}]
  • استبدِل xx برمز لغة الكيان بتنسيق BCP 47، على سبيل المثال، "ar".
@type Text مطلوبة: يجب ضبطها دائمًا على BroadcastEvent.
@id URL مطلوب: معرّف خانة البث بتنسيق معرّف الموارد المنتظم (URI)، مثلاً https://example.com/live/channel1/20191012T2100
@id يجب أن يستوفي المتطلبات التالية:
  • يجب أن يكون فريدًا على مستوى العالم في الكتالوج ومختلفًا عن workPerformed.@id أو broadcastOfEvent.@id (على سبيل المثال، يجب تضمين القناة/الخدمة ووقت بدء البث في معرّف الموارد المنتظم).
  • ثابت: يجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت. وسيتم التعامل معه كسلسلة مبهمة ولا يُشترط أن يكون رابطًا منشورًا.
  • على شكل معرّف الموارد الموحّد (URI)
  • ويجب أن يكون النطاق المستخدَم للقيمة @id مملوكًا من مؤسستك.
ملاحظة مهمة: لا تُدرِج السمة url في BroadcastEvent أو SportsEvent. يجب تقديم السمة الأساسية url فقط في كيان المحتوى الأساسي (Movie أو TVSeries أو TVEpisode). راجِع قسم المعرّف لمزيد من التفاصيل.
name Text مطلوبة: عنوان البرنامج أو الحدث.
description Text وصف العرض أو الحدث الحد الأقصى لعدد الأحرف المسموح به هو 300 حرف. استخدِم مصفوفة لتضمين الأوصاف بلغات متعددة (وصف واحد لكل لغة).
startDate التاريخ مطلوبة: وقت بدء الفعالية بالتنسيق ISO 8601 مع المنطقة الزمنية.
endDate التاريخ تمثّل هذه السمة وقت انتهاء الفعالية بالتنسيق ISO 8601 مع المنطقة الزمنية.
publishedOn BroadcastService مطلوبة إذا كانت السمة منطبقة: حدِّد الكيان BroadcastService الذي يبث هذا البرنامج أو الحدث.

إذا كان المحتوى يُبث على قناة تلفزيونية، تكون هذه السمة مطلوبة. إذا لم يكن المحتوى مرتبطًا بأي قناة تلفزيونية، لا تقدّم هذه السمة.
publishedOn.@type Text اضبط النوع على BroadcastService.
publishedOn.@id URL تمثّل هذه السمة @id لكيان BroadcastService الذي يبث هذا البرنامج أو الحدث.
workPerformed CreativeWork مطلوبة إذا كانت منطبقة: استخدِم هذه السمة عندما يكون المحتوى من أحد أنواع العناصر التالية: Movie وTVSeries وTVEpisode.
ننصح بشدة بأن يتضمّن العنصر BroadcastEvent سمة واحدة على الأقل من السمات التالية:
  • workPerformed
  • broadcastOfEvent
  • تم ضبط موقع contentToBeAnnounced في العنوان true
  • تم ضبط موقع offAir في العنوان true
workPerformed.@type Text اضبط النوع على Movie أو TVSeries أو TVEpisode.
workPerformed.@id URL ‫@id لكيان المحتوى
broadcastOfEvent SportsEvent مطلوبة إذا كانت منطبقة: استخدِم هذه السمة إذا كان المحتوى عبارة عن حدث مباشر:
  • بالنسبة إلى الفعاليات الرياضية، يجب أن تشير هذه السمة إلى كيان SportsEvent.

ننصح بشدة بأن يتضمّن كيان BroadcastEvent واحدًا على الأقل مما يلي:
  • workPerformed
  • broadcastOfEvent
  • تم ضبط موقع contentToBeAnnounced في العنوان true
  • تم ضبط موقع offAir في العنوان true
broadcastOfEvent.@type Text اضبط النوع على SportsEvent.
broadcastOfEvent.@id URL ‫@id لكيان الحدث يجب أن يكون كيان الحدث متوفّرًا في الخلاصة وأن يكون له @id مختلف عن BroadcastEvent.
location نص أو بلد مطلوبة إذا كان BroadcastEvent مخصّصًا لـ SportsEvent، أي يحتوي على السمة broadcastOfEvent: تشير إلى البلد الذي يمكن بثّ SportsEvent الأساسي فيه. يمكن أن يكون هذا الحقل قائمة بالبلدان إذا كان من الممكن بث الحدث الرياضي في بلدان متعددة.
videoFormat Text أعلى دقة جودة متوافقة مع خدمة البث هذه، على سبيل المثال،
  • "SD" للدلالة على الدقة العادية
  • "HD" للدقة العالية
  • ‫"2K" لدقة 2K
  • ‫"4K" لدرجة الدقة 4K
  • ‫"8K" لدرجة الدقة 8K
contentToBeAnnounced منطقية مطلوبة إذا كانت منطبقة: استخدِم هذه السمة إذا كان المحتوى غير معروف في وقت إنشاء الخلاصة.

اضبط القيمة على true عندما لا يكون لدى مقدّم الخدمة معلومات محدّثة حول ما سيتم بثه، وfalse في الحالات الأخرى.
ننصح بشدة أن يتضمّن الكيان BroadcastEvent سمة واحدة على الأقل من السمات التالية:
  • workPerformed
  • broadcastOfEvent
  • تم ضبط موقع contentToBeAnnounced في العنوان true
  • تم ضبط موقع offAir في العنوان true
offAir منطقية مطلوبة إذا كانت منطبقة: يجب ضبطها على true في حال عدم توفّر محتوى مجدوَل للبث في الفترة الزمنية المحدّدة على قناة BroadcastService.
  • اضبط السمتَين name وdescription على "Off Air".
  • يجب أن يمتد كل offAir BroadcastEvent لمدة 4 ساعات أو أقل (لا تُرسِل مجموعات متواصلة لمدة 24 ساعة). عندما تكون القناة متوقفة عن البث لأكثر من 4 ساعات، يجب إرسال كيانات BroadcastEvent متعددة متجاورة وغير متداخلة لمدة 4 ساعات كحد أقصى لكل منها، لكي تحافظ القناة على تغطية كاملة للجدول الزمني على مدار الساعة طوال أيام الأسبوع بدون أي فجوات في بداية نافذة الخلاصة أو نهايتها.
ننصح بشدة بأن يتضمّن كيان 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 Text مطلوبة إذا كانت السمة contentRating تستخدم السمة Rating: قيمة التقييم
contentRating.advisoryCode Text رمز الإشعار بشأن المحتوى تشمل القيم المقبولة D وFV وL وS وV. ‏D = حوار، وFV = عنف خيالي، وL = لغة، وS = محتوى جنسي، وV = عنف.

أمثلة

يتم بث حلقة تلفزيونية على شبكة التلفزيون Example TV (BroadcastService) بين الساعة 9:00 مساءً و9: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"
  }
}

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) بين الساعة 9 مساءً و9:30 مساءً في 12 أكتوبر 2019 غير معروف في وقت إنشاء الخلاصة:

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) متوقفة عن البث بين الساعة 12 ظهرًا و8 مساءً (يتم تمثيلها على شكل مجموعتَين متتاليتَين من 4 ساعات Off Air) وتبث برنامجًا واحدًا باسم My favorite show بين الساعة 8 مساءً و12 صباحًا:

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

يمكنك الاطّلاع على الصفحات التالية للتعرّف على المواضيع ذات الصلة بهذه السمات: