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

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

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

الموقع النوع المتوقّع الوصف
@context Text مطلوب - يتم ضبطه دائمًا على ["http://schema.org", {"@language": "xx"}]
  • استبدِل xx برمز لغة العنصر بتنسيق BCP 47 format، على سبيل المثال "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 مخصّصة لحدث SportsEvent، أي أنّه يتضمّن خاصية broadcastOfEvent: البلد الذي يمكن بث حدث SportsEvent الأساسي فيه. يمكن أن يكون هذا الحقل قائمة بالبلدان إذا كان بإمكان عدة بلدان بث حدث SportsEvent.
videoFormat Text أعلى جودة معتمَدة في خدمة البث هذه على سبيل المثال،
  • "دقة عادية" للحصول على درجة وضوح عالية.
  • "دقة عالية" للحصول على دقة عالية.
  • "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". اطّلِع على قائمة الوكالات.
  • قيمة "التقييم غير معروف" (غير حساسة لحالة الأحرف) للإشارة إلى أنك لا تعرف تقييم الفيلم.
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"
        }
      ]
    }
  }
}

اطلع على الصفحات التالية للحصول على الموضوعات ذات الصلة بهذه الخصائص: