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

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

جدول مواصفات 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 Text أو Organization مطلوبة إذا كان 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"
        }
      ]
    }
  }
}

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