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

يوفّر هذا القسم تفاصيل خصائص ترميز المحتوى لنوع العنصر 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 Text أو Country سمة مطلوبة إذا كان BroadcastEvent خاصًا بحدث رياضي، أي إذا كان يحتوي على السمة broadcastOfEvent: البلد الذي يمكن بث الحدث الرياضي الأساسي فيه يمكن أن يكون هذا الحقل قائمة ببلدان إذا كان بإمكان بلدان متعدّدة بثّ حدث رياضي.
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 Text أو Rating يجب توفيره إذا كان المحتوى مخصّصًا للبالغين، ويُنصح بشدة بتوفيره في جميع الحالات الأخرى. لماذا؟ - التقييم العام لمحتوى البث إذا تم تقديم التقييم حسب الفئة العمرية في شكل سلسلة نصية، يتم قبول الصيغتَين التاليتَين:
  • وكالة التقييم التي تُضاف قبل التقييم مع ترك مسافة بين الاسم والتقييم على سبيل المثال، يجب وصف التقييم "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"
        }
      ]
    }
  }
}

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