מאפייני תגי עיצוב של תוכן של אירועי טלוויזיה בשידור חי

בקטע הזה מפורטים מאפייני התוכן של תגי העיצוב עבור סוג הישות BroadcastEvent. כדי להבין טוב יותר את הקשר בין הסוגים האלה, מומלץ לעיין במושגים בנושא אירועים בשידור חי בטלוויזיה.

טבלת המפרט של BroadcastEvent

נכס הסוג הנדרש תיאור
@context טקסט חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}]
  • מחליפים את xx בקוד השפה של הישות בפורמט BCP 47, לדוגמה, 'en'.
@type טקסט חובה – תמיד מוגדר ל-BroadcastEvent.
@id כתובת URL חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.
@id צריך לעמוד בדרישות הבאות:
  • ייחודי בכל העולם בקטלוג שלכם
  • סטטי; המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם כתובת ה-URL של התוכנית משתנה). המערכת תתייחס לערך הזה כמחרוזת אטומה, והוא לא חייב להיות קישור פעיל.
  • בפורמט של מזהה משאב אחיד (URI)
  • הדומיין שמשמש לערך ‎ @id חייב להיות בבעלות הארגון שלכם.
מכיוון שהערך url של ישות מסוימת עומד בכל הדרישות כמזהה, מומלץ להשתמש בערך url של ישות מסוימת כערך @id. פרטים נוספים זמינים בקטע מזהה.
name טקסט חובה – שם התוכנית או האירוע.
description טקסט תיאור התוכנית או האירוע. מגבלה של 300 תווים. משתמשים במערך כדי לכלול את התיאורים בכמה שפות ובאורכים שונים.
startDate ‫תאריך חובה – שעת ההתחלה של האירוע בפורמט ISO 8601 עם אזור זמן.
endDate ‫תאריך שעת הסיום של האירוע בפורמט ISO 8601 עם אזור זמן.
publishedOn BroadcastService חובה אם רלוונטי – מציינים את ישות BroadcastService שמשדרת את התוכנית או האירוע.

אם התוכן משודר בערוץ טלוויזיה, המאפיין הזה הוא חובה. אם התוכן לא משויך לערוץ טלוויזיה, אל תציינו את המאפיין הזה.
publishedOn.@type טקסט הוגדר ל-BroadcastService.
publishedOn.@id כתובת URL @id של הישות BroadcastService שמשדרת את התוכנית או האירוע.
workPerformed CreativeWork חובה אם רלוונטי – משתמשים במאפיין הזה אם התוכן הוא אחד מסוגי הישויות הבאים: Movie,‏ TVSeries ו-TVEpisode.
מומלץ מאוד שלישויות מסוג BroadcastEvent יהיה לפחות אחד מהמאפיינים הבאים:
  • workPerformed
  • broadcastOfEvent
  • הכתובת true הוגדרה כמיקום הcontentToBeAnnounced
  • הכתובת true הוגדרה כמיקום הoffAir
workPerformed.@type טקסט הערך שמוגדר הוא Movie, ‏TVSeries או TVEpisode.
workPerformed.@id כתובת URL הערך @id של ישות התוכן.
broadcastOfEvent SportsEvent חובה אם רלוונטי – משתמשים במאפיין הזה אם התוכן הוא אירוע בשידור חי:
  • באירוע ספורט, המאפיין הזה צריך להתייחס לישות SportsEvent.

מומלץ מאוד שBroadcastEvent ישות תכלול לפחות אחד מהמאפיינים הבאים:
  • workPerformed
  • broadcastOfEvent
  • הכתובת true הוגדרה כמיקום הcontentToBeAnnounced
  • הכתובת true הוגדרה כמיקום הoffAir
broadcastOfEvent.@type טקסט הוגדר ל-SportsEvent.
broadcastOfEvent.@id כתובת URL ה-@id של ישות האירוע. יש בפיד ישות מסוג event עם ערך @id ששונה מהערך של BroadcastEvent.
location טקסט או מדינה חובה אם BroadcastEvent הוא SportsEvent, כלומר אם יש לו מאפיין broadcastOfEvent – המדינה שבה אפשר לשדר את SportsEvent. השדה הזה יכול להיות רשימה של מדינות אם אפשר לשדר את אירוע הספורט בכמה מדינות.
videoFormat טקסט ההגדרה האיכותית ביותר שנתמכת בשירות השידור הזה. לדוגמה,
  • ‫"SD" לאיכות רגילה.
  • ‫HD לאיכות גבוהה.
  • ‫2K לרזולוציית 2K.
  • ‫4K לרזולוציית 4K.
  • ‫8K לרזולוציית 8K.
contentToBeAnnounced בוליאני חובה אם רלוונטי – משתמשים במאפיין הזה אם התוכן לא ידוע בזמן יצירת הפיד.

מגדירים את הערך ל-true אם לספק אין מידע עדכני על מה שישודר, false אחרת.
מומלץ מאוד שישות BroadcastEvent תכלול לפחות אחד מהמאפיינים הבאים:
  • workPerformed
  • broadcastOfEvent
  • הכתובת true הוגדרה כמיקום הcontentToBeAnnounced
  • הכתובת true הוגדרה כמיקום הoffAir
offAir בוליאני חובה אם רלוונטי – משתמשים במאפיין הזה אם אין שידור תוכן מתוכנן למשבצת הזמן.
מומלץ מאוד שישות BroadcastEvent תכלול לפחות אחד מהמאפיינים הבאים:
  • workPerformed
  • broadcastOfEvent
  • הכתובת true הוגדרה כמיקום הcontentToBeAnnounced
  • הכתובת true הוגדרה כמיקום הoffAir
isLiveBroadcast בוליאני מגדירים את הערך true אם מדובר באירוע בשידור חי, למשל אירוע ספורט או קונצרט.
potentialAction WatchAction חובה אם רלוונטי – אם התוכן משודר כאירוע סטרימינג בשידור חי בערוץ (כשהערך של contentToBeAnnounced הוא false או הערך של offAir הוא false) , צריך להשתמש במאפיין הזה כדי לספק את הקישור העמוק לאירוע.
identifier PropertyValue מזהה חיצוני שמזהה את תוכן השידור. פרטים נוספים זמינים בקטע מאפייני מזהים.
  • הערה: סוג הישות BroadcastEvent מקבל רק ערכים מסוג propertyID שהם TMS_ID או TMS_ROOT_ID.
  • צריך לציין את המאפיין הזה רק במקרים שבהם לא נעשה שימוש במאפיין workPerformed או במאפיין broadcastOfEvent כדי להפנות לישות Movie, TVSeries, TVEpisode או SportsEvent ברמה העליונה.
  • הערך של המאפיין צריך לשקף את 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 טקסט חובה אם ב-contentRating נעשה שימוש ב-Rating – ערך הסיווג.
contentRating.advisoryCode טקסט קוד האזהרה לגבי התוכן. הערכים הקבילים כוללים D,‏ FV,‏ L,‏ S ו-V. ‏ D = Dialogue (דיאלוג),‏ FV = Fantasy Violence (אלימות דמיונית),‏ L = Language (שפה),‏ S = Sexual Content (תוכן מיני),‏ V = Violence (אלימות).

דוגמאות

פרק של תוכנית טלוויזיה משודר ברשת הטלוויזיה Example TV (BroadcastService) בין השעות 21:00 ל-21: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) בין השעות 21:00 ל-21: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:00 ל-20:00 ומשדר תוכנית אחת בשם My favorite show בין השעות 20:00 ל-12:00:

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

במאמרים הבאים מפורטים נושאים שקשורים לנכסים האלה: