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

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

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

الموقع النوع المتوقّع الوصف
@context Text مطلوب: يتم ضبطه دائمًا على ["http://schema.org", {"@language": "xx"}]
  • استبدِل xx برمز اللغة الخاص بالكيان بتنسيق BCP 47، مثل "en".
@type Text مطلوبة - يجب ضبطها دائمًا على BroadcastEvent.
@id URL مطلوبة: معرّف المحتوى بتنسيق معرّف الموارد المنتظم (URI)، مثلاً https://example.com/1234abc.
@id يجب أن يستوفي المتطلبات التالية:
  • فريد على مستوى العالم في الكتالوج
  • ثابت: يجب أن يكون المعرّف ثابتًا ولا يتغير بمرور الوقت (حتى إذا تغيرت السمة url الخاصة بالبرنامج). وسيتم التعامل معه كسلسلة مبهمة ولا يُشترط أن يكون رابطًا منشورًا.
  • في شكل معرّف موارد موحّد (URI)
  • يجب أن يكون النطاق المستخدَم للقيمة @id مملوكًا من مؤسستك.
بما أنّ url الخاص بالكيان يستوفي جميع المتطلبات كمعرّف، ننصحك باستخدام url الخاص بالكيان كـ @id. راجِع قسم المعرّف لمزيد من التفاصيل.
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 فيه. يمكن أن يكون هذا الحقل قائمة بالبلدان إذا كان بإمكان عدة بلدان بث SportsEvent.
videoFormat Text تمثّل هذه السمة أعلى دقة متوافقة مع خدمة البث هذه، مثل
  • ‫"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 WatchAction مطلوبة إذا كان ذلك منطبقًا: إذا تم بث المحتوى كحدث بث مباشر بدون قناة (مع ضبط contentToBeAnnounced على false أو ضبط 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": "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 مساءً، وتبث برنامجًا واحدًا باسم My favorite show بين الساعة 8 مساءً و12 ظهرًا:

BroadcastEvent 

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

}

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

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