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

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

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

מאפיין (property) הסוג הנדרש תיאור
@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 של ישות האירוע. ישות האירוע חייבת להיות קיימת בפיד, והערך שלה @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 = Dialogue , 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:30 ל-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"
        }
      ]
    }
  }
}

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