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

המקטע הזה מספק את הפרטים של מאפייני תגי העיצוב של תוכן עבור סוג הישות 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 של ישות האירוע. ישות האירוע חייבת להיכלל בפיד ולכלול @id השונה מזה של BroadcastEvent.
location טקסט או מדינה חובה אם האירוע BroadcastEvent מיועד לאירוע SportsEvent, כלומר בנכס broadcastOfEvent – המדינה שבה ניתן לשדר את אירוע SportsEvent המקורי. השדה הזה יכול להיות רשימת מדינות אם כמה מדינות יכולות לשדר את האירוע SportsEvent.
videoFormat טקסט הגדרת האיכות הגבוהה ביותר שנתמכת בשירות השידור הזה. לדוגמה,
  • 'SD' להגדרה רגילה.
  • 'HD' לאיכות 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 ו-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"
        }
      ]
    }
  }
}

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