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

يقدّم هذا القسم تفاصيل سمات ترميز المحتوى لنوع الكيان 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 الأساسي فيه. يجب أن يكون رمز بلد مكوّنًا من حرفَين كبيرَين وفقًا لمعيار ISO 3166-1 alpha-2 (مثلاً، "US" أو "CA")، سواء تم تقديمه كـ Text أو في السمة name لعنصر Country. استخدِم مصفوفة لإدراج بلدان متعدّدة.
أمثلة: "location": "US" أو "location": {"@type": "Country", "name": "US"}
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 مساءً و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 مساءً (تم تصميمها على شكل مجموعتَين متتاليتَين من Off Air مدة كل منهما 4 ساعات) وتبث برنامجًا واحدًا باسم 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"
        }
      ]
    }
  }
}

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