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

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

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

נכס הסוג הנדרש תיאור
@context טקסט חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}]
  • מחליפים את xx בקוד השפה של הישות בפורמט BCP 47, לדוגמה, 'iw'.
@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 של ישות האירוע. ישות האירוע חייבת להתקיים בפיד, ויש לה ערך @id שונה מערך BroadcastEvent.
location טקסט או מדינה חובה אם BroadcastEvent הוא של SportsEvent, כלומר יש לו את המאפיין broadcastOfEvent – המדינה שבה אפשר לשדר את SportsEvent הבסיסי. השדה הזה יכול להיות רשימה של מדינות אם כמה מדינות יכולות לשדר את 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.
  • צריך לספק את המאפיין הזה רק במקרים שבהם לא קיימת הפניה ליישות 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 טקסט חובה אם contentRating משתמש ב-Rating – הערך של הדירוג.
contentRating.advisoryCode טקסט קוד האזהרה של התוכן. הערכים הקבילים הם D,‏ FV,‏ L,‏ S ו-V. D = דו-שיח, FV = אלימות פנטזיה, L = שפה, S = תוכן מיני, V = אלימות.

דוגמאות

פרק בתוכנית טלוויזיה משודר ברשת הטלוויזיה 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"
        }
      ]
    }
  }
}

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