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

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

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

נכס הסוג הצפוי תיאור
@context טקסט חובה – תמיד מוגדר לערך ["http://schema.org", {"@language": "xx"}]
  • מחליפים את xx בקוד השפה של הישות בפורמט BCP 47, לדוגמה, "en".
@type טקסט חובה – תמיד מוגדר לערך BroadcastEvent.
@id כתובת URL חובה – המזהה של משבצת השידור בפורמט URI, לדוגמה: https://example.com/live/channel1/20191012T2100.
@id צריך לעמוד בדרישות הבאות:
  • ייחודי בכל הקטלוג ושונה מ-workPerformed.@id או מ-broadcastOfEvent.@id (לדוגמה, שילוב של הערוץ/השירות ושעת ההתחלה של השידור ב-URI)
  • סטטי: המזהה צריך להיות יציב ולא להשתנות לאורך זמן. הוא יטופל כמחרוזת אטומה ולא חייב להיות קישור פעיל.
  • בפורמט של מזהה משאב אחיד (URI)
  • הדומיין שמשמש לערך @id חייב להיות בבעלות הארגון שלכם.
חשוב: אין לכלול מאפיין url ב-BroadcastEvent או ב-SportsEvent. צריך לספק את ה-url הקנוני רק בישות התוכן הבסיסית (Movie,‏ TVSeries או TVEpisode). פרטים נוספים זמינים בקטע מזהה.
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 הבסיסי. השדה הזה יכול להיות רשימה של מדינות אם אפשר לשדר את אירוע הספורט בכמה מדינות.
videoFormat טקסט האיכות הגבוהה ביותר שנתמכת בשירות השידור הזה, לדוגמה:
  • "SD" לאיכות רגילה.
  • "HD" לאיכות גבוהה.
  • ‫"2K" לרזולוציית 2K.
  • ‫"4K" לרזולוציית 4K.
  • "8K" לרזולוציית 8K.
contentToBeAnnounced בוליאני חובה אם רלוונטי – צריך להשתמש במאפיין הזה אם התוכן לא ידוע בזמן יצירת הפיד.

צריך להגדיר את הערך true אם לספק אין מידע עדכני לגבי התוכן שישודר, ואת הערך false אם יש לו מידע כזה.
מומלץ מאוד שישות מסוג BroadcastEvent תכלול לפחות אחד מהמאפיינים הבאים:
  • workPerformed
  • broadcastOfEvent
  • הכתובת true הוגדרה כמיקום הcontentToBeAnnounced
  • הכתובת true הוגדרה כמיקום הoffAir
offAir בוליאני חובה אם רלוונטי – צריך להגדיר את הערך true כשאין שידור תוכן מתוכנן למשבצת הזמן בערוץ BroadcastService.
  • מגדירים את name וגם את description להיות "Off Air".
  • כל offAir BroadcastEvent חייב להימשך 4 שעות או פחות (אין לשדר בלוקים רציפים של 24 שעות). כשהערוץ לא משדר במשך יותר מ-4 שעות, צריך להפיק כמה ישויות BroadcastEvent רציפות שלא חופפות, באורך של עד 4 שעות כל אחת, כדי שהערוץ ישמור על לוח זמנים מלא של 24/7 בלי פערים בתחילת חלון הפיד או בסופו.
מומלץ מאוד שישות מסוג BroadcastEvent תכלול לפחות אחד מהמאפיינים הבאים:
  • workPerformed
  • broadcastOfEvent
  • הכתובת true הוגדרה כמיקום הcontentToBeAnnounced
  • הכתובת true הוגדרה כמיקום הoffAir
isLiveBroadcast בוליאני מגדירים ערך בוליאני true (ללא מירכאות) אם השידור הזה הוא שידור חי (לדוגמה, משחק ספורט בשידור חי או חדשות יומיות בשידור חי), או false לתוכניות שאינן בשידור חי ולשידורים חוזרים.
potentialAction WatchAction חובה אם רלוונטי – אף פעם אל תספקו את potentialAction ב-BroadcastEvent כש-broadcastOfEvent מפנה אל SportsEvent (מקמו את כל קישורי העומק של הספורט ב-SportsEvent.potentialAction) או כש-publishedOn מפנה אל ערוץ BroadcastService (מקמו את קישורי העומק של הערוץ ב-BroadcastService.potentialAction). ספקו את BroadcastEvent.potentialAction רק לשידורים חיים ללא ערוץ שלא מפנים אל SportsEvent (כמו תוכן נלווה עצמאי בשידור חי עם contentToBeAnnounced ו-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": "Content To Be Announced",
  "description": "Content 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 (מיוצג כשני בלוקים רציפים של 4 שעות Off Air) ומשדר תוכנית אחת בשם My favorite show בין השעות 20:00 ל-24:00:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId1",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T12:00-08:00",
  "endDate": "2019-10-12T16: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",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T16: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/randomUniqueEventId3",
  "name": "My favorite show",
  "description": "Evening broadcast of My favorite show.",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/tv_series/my_favorite_show"
  },
  "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"
        }
      ]
    }
  }
}

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