בקטע הזה מפורטים המאפיינים של רכיבי ה-Markup של התוכן עבור סוגי הישויות BroadcastService
, CableOrSatelliteService
, TelevisionChannel
, Organization
. כדי להבין טוב יותר את הקשר בין הסוגים האלה, כדאי לעיין במושגים של ערוצי LiveTV.
טבלת המפרט של BroadcastService
נכס | הסוג הנדרש | תיאור |
---|---|---|
@context |
טקסט | חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}]
|
@type |
טקסט | חובה – תמיד מוגדר ל-BroadcastService . |
@id |
כתובת URL | חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.@id חייב לעמוד בדרישות הבאות:
url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id . פרטים נוספים זמינים בקטע מזהה. |
url |
כתובת URL | חובה אם רלוונטי – כתובת ה-URL הקנונית של שירות השידור, אם הערוץ זמין לצפייה באינטרנט. הוא אופציונלי לשירות שמשודר בכבלים/לוויין/באוויר. Google משתמשת בכתובת ה-URL הזו כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google.url חייבת לעמוד בדרישות הבאות:
urlTemplate של האובייקט היעד. |
name |
טקסט | חובה – שם הרשת.
|
broadcastDisplayName |
טקסט | חובה – השם המוצג של הערוץ, שעשוי להופיע בדרך כלל במדריכי תוכניות וכו'. הערך יכול להיות זהה לערך השם. |
callSign |
טקסט | הכינוי הרשמי של שירות השידור שהונפקה על ידי הממשלה. |
inLanguage |
טקסט או שפה | מומלץ מאוד למה? שפת השידור הראשית של הערוץ. יש להשתמש באחד מקודי השפות מתקן IETF BCP 47. |
category |
טקסט | מומלץ מאוד למה? קטגוריה של הפריט. אפשר להשתמש בסימנים גדולים או בקו נטוי כדי לציין באופן לא רשמי היררכיית קטגוריות. לדוגמה: ספורט, ספורט > פוטבול, חדשות, סרט, מוזיקה, סרט תיעודי. |
contentRating |
טקסט או דירוג | חובה לשירות שידור טלוויזיה למבוגרים בלבד – הסיווג המחמיר ביותר לתוכן שמשודר בערוץ. אם סיווג התוכן מצוין כמחרוזת טקסט, צריך להוסיף את סוכנות הסיווג לפני הסיווג עם רווח באמצע. לדוגמה, סיווג 'TV-Y' מסוכנות 'TVPG' בארה"ב מתואר כ'TVPG TV-Y'. רשימת הסוכנויות |
contentRating.author |
ארגון | חובה אם contentRating משתמש ב-Rating – שם סוכנות הדירוג. |
contentRating.ratingValue |
טקסט | חובה אם contentRating משתמש ב-Rating – הערך של הדירוג. |
contentRating.advisoryCode |
טקסט | קוד האזהרה של התוכן. הערכים הקבילים הם D, FV, L, S ו-V. D = דו-שיח, FV = אלימות פנטזיה, L = שפה, S = תוכן מיני, V = אלימות. |
description |
טקסט | תיאור של שירות השידור. מגבלה של 300 תווים. אפשר להשתמש במערך כדי לספק את התיאורים בכמה שפות ו/או באורך שונה. |
slogan |
טקסט | הסלוגן של שירות השידור. |
areaServed |
מדינה, מדינה, עיר או GeoShape | חובה אם רלוונטי – השדה הזה נדרש אם החלפת הערוץ מתבצעת על ידי ספק שירותי הטלוויזיה – האזור שבו המשתמשים יכולים לקבל את שירות השידור. כדי לציין מדינות, צריך להשתמש בקוד המדינה לפי תקן ISO 3166-1. |
logo |
ImageObject | חובה אם מבצעים שילוב עם GoogleTV. מומלץ מאוד אחרת למה? תמונה שמייצגת את שירות השידור הזה.
|
potentialAction |
WatchAction | חובה אם רלוונטי – אובייקט של סימון פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני רכיבי ה-Action Markup.
|
videoFormat |
טקסט | הגדרת האיכות הגבוהה ביותר שנתמכת בשירות השידור הזה. לדוגמה,
|
broadcastTimezone |
טקסט | אזור הזמן של שירות השידור הזה בפורמט IANA. לדוגמה, America/Los_Angeles. שימוש במערך לכמה אזורי זמן. |
broadcastAffiliateOf |
ארגון | חובה – רשת הטלוויזיה שמספקת את תוכניות הטלוויזיה של שירות השידור הזה, או הארגון שאליו שייך שירות השידור הזה. |
broadcastAffiliateOf.@id |
טקסט | חובה – מגדירים את הערך @id של רשת הטלוויזיה. |
broadcastAffiliateOf.@type |
טקסט | חובה – תמיד מוגדר ל-Organization . |
identifier |
PropertyValue | מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות הזו, כמו _PARTNER_ID_. מותר להשתמש במספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהה. |
popularityScore |
PopularityScoreSpecification | מומלץ מאוד למה? ציון ש-Google משתמשת בו, יחד עם אותות אחרים, כדי לקבוע איזה מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג. לכן, סולם הציונים צריך להיות עקבי בכל הפידים, בין כל הישויות בקטלוג. כברירת מחדל, דירוג הפופולריות של ישות מוגדר ל-0. |
popularityScore.@type |
טקסט | הערך תמיד מוגדר ל-PopularityScoreSpecification . |
popularityScore.value |
מספר | ערך מספרי לא שלילי שמייצג את הפופולריות של הישות. ככל שהציון גבוה יותר, כך הפופולריות גבוהה יותר. |
popularityScore.eligibleRegion |
מדינה | האזורים שבהם ציון הפופולריות הזה רלוונטי. אם ציון הפופולריות רלוונטי באופן גלובלי, מגדירים אותו כ-EARTH . כברירת מחדל, הנכס הזה מוגדר ל-EARTH . Note: הפופולריות הספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH) |
דוגמה ל-BroadcastService
{
"@context": [
"http://schema.org",
{
"@language": "en"
}
],
"@type": "BroadcastService",
"@id": "http://example.com/stations/example-tv",
"name": "EXAMPLE-TV",
"broadcastDisplayName": "ABCD",
"url": "http://example.com/stations/example-tv",
"callSign": "EXA-TV",
"videoFormat": "SD",
"inLanguage": "en",
"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"
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 178,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
},
"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",
"authenticator": {
"@type": "Organization",
"name": "TVE"
}
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
},
"logo": [
{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Example Logo Light",
"contentUrl": "http://example.com/images/example-logo-light.jpg",
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forLightBackground"
]
}
]
},
{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Example Logo Dark",
"contentUrl": "http://example.com/images/example-logo-dark.jpg",
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forDarkBackground"
]
}
]
}
]
}
טבלת המפרט של CableOrSatelliteService
נכס | הסוג הנדרש | תיאור |
---|---|---|
@context |
טקסט | חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}]
|
@type |
טקסט | חובה – תמיד מוגדר ל-CableOrSatelliteService . |
@id |
כתובת URL | חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.@id חייב לעמוד בדרישות הבאות:
url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id . פרטים נוספים זמינים בקטע מזהה. |
name |
טקסט | חובה – השם של שירות הטלוויזיה.
|
areaServed |
מדינה, מדינה, עיר או GeoShape | חובה – האזור שבו המשתמשים יכולים לקבל את שירות השידור.
|
provider |
ארגון | חובה – הספק הראשי של השירות, אם רלוונטי. לדוגמה, ExampleTV היא הספקית של השירותים האזוריים שלה, ExampleTV San Francisco ו-ExampleTV San Diego. |
provider.@id |
טקסט | חובה – המזהה של מפעיל הטלוויזיה. |
provider.@type |
טקסט | חובה – תמיד מוגדר ל-Organization . |
identifier |
PropertyValue | מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות הזו, כמו מזהה TMS של Gracenote לשירות השידור הזה. מותר להשתמש במספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהה. |
דוגמאות ל-CableOrSatelliteService
דוגמה לשירות לוויין או כבלים:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"CableOrSatelliteService",
"@id":"http://example.com/provider-lineups/exampletv-san-francisco",
"name":"ExampleTV San Francisco",
"provider": {
"@type": "Organization",
"@id": "http://example.com/providers/exampletv"
},
"areaServed":[
{
"@type":"GeoShape",
"@id": "http://example.com/area1"
}
],
"identifier": {
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12345"
}
}
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
}
דוגמה לחברה וירטואלית להפצת תכנות וידאו בכמה ערוצים (vMVPD):
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/my-online-example-tv",
"name":"My Online Example TV",
"provider": {
"@type": "Organization",
"@id": "http://my-online-tv.com"
},
"areaServed":[
{
"@type":"Country",
"name": "US",
},
{
"@type":"Country",
"name": "CA",
}
]
}
טבלת המפרט של TelevisionChannel
נכס | הסוג הנדרש | תיאור |
---|---|---|
@context |
טקסט | חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}]
|
@type |
טקסט | חובה – תמיד מוגדר ל-TelevisionChannel . |
@id |
כתובת URL | חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.@id חייב לעמוד בדרישות הבאות:
url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id . פרטים נוספים זמינים בקטע מזהה. |
broadcastChannelId |
טקסט | חובה – מזהה ייחודי שבעזרתו אפשר לזהות את BroadcastService כשירות כבלים, לוויין או טלוויזיה באינטרנט.
|
channelOrder |
מספר | חובה ל-GoogleTV, אופציונלי במקרים אחרים – משתמשים במאפיין הזה כדי לציין את הסדר שבו הערוצים יוצגו בלוח השידורים האלקטרוני בשילובים עם Google TV. השדה channelOrder צריך להיות ייחודי בכל הערוצים בפיד, ובאופן אידיאלי הוא צריך להתחיל בספרה 1. הערך של channelOrder לא יכול להיות שלילי או 0. |
broadcastServiceTier |
טקסט | משתמשים בערכים הבאים:
|
inBroadcastLineup |
CableOrSatelliteService | חובה – ה-@id של ה-CableOrSatelliteService שמספק את הערוץ הזה לצופים. |
providesBroadcastService |
BroadcastService | חובה – ה-@id של ה-BroadcastService שהתוכניות שלו מוצגות בערוץ הזה. |
דוגמאות ל-TelevisionChannel
דוגמה לערוץ טלוויזיה בכבלים או בלוויין:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"TelevisionChannel",
"@id":"http://example.com/channels/exampleTV/example-tv-7",
"broadcastChannelId":"7",
"channelOrder": 1,
"broadcastServiceTier":["Premium", "Standard"],
"inBroadcastLineup":{
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/exampleTV-san-francisco"
},
"providesBroadcastService":{
"@type":"BroadcastService",
"@id":"http://example.com/stations/example-tv"
}
}
דוגמה לערוץ טלוויזיה אונליין:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"TelevisionChannel",
"@id":"http://example.com/channels/my-online-example-tv/sport-channel",
"broadcastChannelId":"sport-channel",
"channelOrder": 3,
"broadcastServiceTier":"Premium",
"inBroadcastLineup":{
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/my-online-example-tv"
},
"providesBroadcastService":{
"@type":"BroadcastService",
"@id":"http://example.com/stations/sport-channel"
}
}
טבלת המפרט של הארגון
נכס | הסוג הנדרש | תיאור |
---|---|---|
@context |
טקסט | חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}]
|
@type |
טקסט | חובה – תמיד מוגדר ל-Organization . |
@id |
כתובת URL | חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.@id חייב לעמוד בדרישות הבאות:
url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id . פרטים נוספים זמינים בקטע מזהה. |
name |
טקסט | חובה – השם של ערוץ הטלוויזיה, ספק התוכן של הטלוויזיה או מפעיל הטלוויזיה.
|
description |
טקסט | תיאור של הארגון. מגבלה של 300 תווים. אפשר להשתמש במערך כדי לספק את התיאורים בכמה שפות ו/או באורך שונה. |
sameAs |
כתובת URL | מומלץ מאוד למה? כתובת URL לדף בוויקיפדיה שאפשר לזהות בה את ערוץ הטלוויזיה. השם הזה צריך להיות שונה מנכס ה-URL. אפשר לאכלס רק בדף בוויקיפדיה שמתייחס לישות יחידה של ערוץ או ערוץ טלוויזיה. שימו לב שבדפי ויקיפדיה עשויה להופיע המונחה 'ערוץ'. |
potentialAction |
WatchAction | חובה אם רלוונטי – השדה הזה נדרש אם יש לכם כמה ערוצים (BroadcastService) שמפנים לארגון. אובייקט סימון של פעולה שמספק את פרטי הפעולה. פרטים נוספים זמינים במאמר מאפייני רכיבי ה-Action Markup.
|
url |
כתובת URL | כתובת ה-URL של הארגון. Google משתמשת בכתובת ה-URL הזו כדי להתאים במדויק את הארגון הזה לארגון שמופיע במסדי הנתונים של Google. |
identifier |
PropertyValue | מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות הזו, כמו מזהה TMS של הארגון הזה. מותר להשתמש במספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהה. |
popularityScore |
PopularityScoreSpecification | מומלץ מאוד למה? ציון ש-Google משתמשת בו, יחד עם אותות אחרים, כדי לקבוע איזה מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג. לכן, סולם הציונים צריך להיות עקבי בכל הפידים, בין כל הישויות בקטלוג. כברירת מחדל, דירוג הפופולריות של ישות מוגדר ל-0. |
popularityScore.@type |
טקסט | הערך תמיד מוגדר ל-PopularityScoreSpecification . |
popularityScore.value |
מספר | ערך מספרי לא שלילי שמייצג את הפופולריות של הישות. ככל שהציון גבוה יותר, כך הפופולריות גבוהה יותר. |
popularityScore.eligibleRegion |
מדינה | האזורים שבהם ציון הפופולריות הזה רלוונטי. אם ציון הפופולריות רלוונטי באופן גלובלי, מגדירים אותו כ-EARTH . כברירת מחדל, הנכס הזה מוגדר ל-EARTH . Note: הפופולריות הספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH) |
דוגמה לארגון
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network",
"name":"ABCD",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12345"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-12345"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/networkstream",
"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": "2050-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 178,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
דפים קשורים
בדפים הבאים מפורטים נושאים שקשורים לנכסים האלה: