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

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

דפים קשורים

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

• זיהוי סוגי הישויות של התוכן
• איסוף המזהה, כתובת ה-URL והשם של התוכן
• איסוף המטא-נתונים של התוכן