本節提供 BroadcastService
、CableOrSatelliteService
、TelevisionChannel
、Organization
實體類型的內容標記屬性詳細資料。如要進一步瞭解這些類型之間的關係,請參閱直播電視頻道概念。
BroadcastService 規格表
屬性 | 預期類型 | 說明 |
---|---|---|
@context |
Text | 必要 - 一律設定為 ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | 必要 - 一律設為 BroadcastService 。 |
@id |
網址 | 必要 - 內容 ID 的 URI 格式,例如 https://example.com/1234abc。@id 必須符合下列規定:
url 符合所有需求條件,因此建議您使用實體的 url 做為 @id 。詳情請參閱「ID」一節。 |
url |
網址 | 必要 (如果適用):播送服務的標準網址 (如果頻道可在網際網路上觀看)。對於透過有線電視/衛星服務/無線傳輸的服務,這是選擇性性。Google 會使用這個網址比對動態饋給中的內容與 Google 資料庫中的內容。 「 url 」必須符合下列規定:
urlTemplate 屬性。 |
name |
Text | 必要 - 網路的名稱。
|
broadcastDisplayName |
Text | 必要 - 使用者通常能在節目指南中看到的聯播網顯示名稱;值可能與名稱相同。 |
callSign |
Text | 政府發布的廣播服務招牌。 |
inLanguage |
文字或語言 | 強烈建議為什麼?頻道的主要廣播語言。請使用 IETF BCP 47 標準中的其中一個語言代碼。 |
category |
Text | 強烈建議為什麼?商品類別。較寬的符號或斜線可用來非正式的指定類別階層,例如「運動」、「運動」>「足球」、「新聞」、「電影」、「音樂」、「紀錄片」。 |
contentRating |
文字或評分 | 這是僅限成人使用的電視廣播服務的必要選項:這是針對頻道內容播送最嚴格的限制。如果內容分級採用「文字」字串,則內容分級前必須在內容分級開頭加上空格,例如美國的「TVPG」分級是「TVPG TV-Y」。請參閱代理商清單。 |
contentRating.author |
文字或機構 | 如果 contentRating 使用 Rating ,則為必要欄位 - 評分機構的名稱。 |
contentRating.ratingValue |
Text | 如果 contentRating 使用 Rating ,則為必要值。 |
contentRating.advisoryCode |
Text | 內容的諮詢程式碼。接受的值包括:D、FV、L、S 和 V。D = Dialogue, FV = Fantasy Violence, L = Language, S = 色情內容,V = 暴力。 |
description |
Text | 廣播服務的說明。長度上限為 300 個半形字元請使用陣列提供多種語言和/或時間長度不同的說明。 |
slogan |
Text | 廣播服務的標語。 |
areaServed |
Country、State、City 或 GeoShape | 必要 (如果適用):如果頻道切換設定已由電視服務供應商填寫 - 使用者預期可以接收廣播服務的區域,就必須完成這項設定。請使用 ISO 3166-1 國家/地區代碼指定國家/地區。 |
logo |
ImageObject | 如果與 Google TV 整合,則為必填。強烈建議,否則為什麼?代表這項廣播服務的圖片。
|
potentialAction |
WatchAction | 必要 (必要) - 動作標記物件,提供動作的詳細資料。詳情請參閱動作標記屬性。
|
videoFormat |
Text | 此廣播服務支援的最高品質定義,例如
|
broadcastTimezone |
Text | 這項廣播服務的時區,採用 IANA 格式,例如 America/Los_Angeles。陣列包含多個時區。 |
broadcastAffiliateOf |
機構組織 | 必要 - 提供這項廣播服務或節目所屬的機構的電視聯播網。 |
broadcastAffiliateOf.@id |
Text | 必要 - 設為電視聯播網的 @id 。 |
broadcastAffiliateOf.@type |
Text | 必要 - 一律設為 Organization 。 |
identifier |
PropertyValue | 強烈建議為什麼?- 代表這個實體的外部 ID 或其他 ID,例如 _PARTNER_ID_。可使用多個 ID。詳情請參閱「ID 屬性」一節。 |
popularityScore |
熱門分數規範 | 強烈建議為什麼?Google 會根據分數和其他信號,決定向使用者播放的媒體。這個分數代表內容相對於目錄中其他內容的熱門程度,因此該分數在動態饋給中的所有實體中必須保持一致。實體的熱門程度預設為 0。 |
popularityScore.@type |
Text | 一律設為 PopularityScoreSpecification 。 |
popularityScore.value |
Number | 非負數數值代表實體的熱門程度,分數越高,表示人氣越高。 |
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 |
Text | 必要 - 一律設定為 ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | 必要 - 一律設為 CableOrSatelliteService 。 |
@id |
網址 | 必要 - 內容 ID 的 URI 格式,例如 https://example.com/1234abc。@id 必須符合下列規定:
url 符合所有需求條件,因此建議您使用實體的 url 做為 @id 。詳情請參閱「ID」一節。 |
name |
Text | 必要 - 電視服務的名稱。
|
areaServed |
Country、State、City 或 GeoShape | 必要 - 使用者預期可以接收廣播服務的區域。
|
provider |
機構組織 | 必要 - 服務的父項供應商 (如適用)。舉例來說,「ExampleTV」是區域服務 ExampleTV San Francisco 和「ExampleTV San Diego」等區域的服務供應商。 |
provider.@id |
Text | 必要 - 電視業者的 ID。 |
provider.@type |
Text | 必要 - 一律設為 Organization 。 |
identifier |
PropertyValue | 強烈建議為什麼?- 可識別這個實體的外部 ID 或其他 ID,例如這個廣播服務的 Gracenote TMS ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。 |
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 |
Text | 必要 - 一律設定為 ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | 必要 - 一律設為 TelevisionChannel 。 |
@id |
網址 | 必要 - 內容 ID 的 URI 格式,例如 https://example.com/1234abc。@id 必須符合下列規定:
url 符合所有需求條件,因此建議您使用實體的 url 做為 @id 。詳情請參閱「ID」一節。 |
broadcastChannelId |
Text | 必要 - 會將這個 BroadcastService 視為有線電視、衛星網路或網際網路電視服務的專用 ID。
|
channelOrder |
Number | Google TV 為必要欄位,對於其他欄位而言則為必填 - 使用這項屬性,指出 Google TV 整合作業的電子版節目指南中應顯示頻道的順序。 在動態饋給中,所有管道的 channelOrder 均不得重複,通常應從 1 開始。「channelOrder 」的值不得為負值或 0。 |
broadcastServiceTier |
Text | 請使用下列的值:
|
inBroadcastLineup |
CableOrSatelliteService | 必要 - 為觀眾提供這個頻道的 CableOrSatelliteService 的 @id 。 |
providesBroadcastService |
BroadcastService | 必要 - 由這個頻道提供的節目 BroadcastService 的 @id 。 |
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 |
Text | 必要 - 一律設定為 ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | 必要 - 一律設為 Organization 。 |
@id |
網址 | 必要 - 內容 ID 的 URI 格式,例如 https://example.com/1234abc。@id 必須符合下列規定:
url 符合所有需求條件,因此建議您使用實體的 url 做為 @id 。詳情請參閱「ID」一節。 |
name |
Text | 必要 - 電視聯播網、電視內容供應者或電視業者的名稱。
|
description |
Text | 機構的說明。長度上限為 300 個半形字元請使用陣列提供多種語言和/或時間長度不同的說明。 |
sameAs |
網址 | 強烈建議為什麼?可識別電視聯播網的維基百科頁面網址。這個值必須與網址屬性不同。僅在維基百科上介紹「單一」頻道/網路實體。請注意,維基百科頁面中可能會使用「頻道」一詞。 |
potentialAction |
WatchAction | 必要 (如果適用) - 如果你有多個頻道 (BroadcastService),就必須提供此項目。動作標記物件,提供動作的詳細資料。詳情請參閱動作標記屬性。
|
url |
網址 | 機構的網址。Google 會使用這個網址準確比對這個機構與 Google 資料庫中的機構。 |
identifier |
PropertyValue | 強烈建議為什麼?- 可識別這個實體的外部 ID 或其他 ID,例如這個機構的 TMS ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。 |
popularityScore |
熱門分數規範 | 強烈建議為什麼?Google 會根據分數和其他信號,決定向使用者播放的媒體。這個分數代表內容相對於目錄中其他內容的熱門程度,因此該分數在動態饋給中的所有實體中必須保持一致。實體的熱門程度預設為 0。 |
popularityScore.@type |
Text | 一律設為 PopularityScoreSpecification 。 |
popularityScore.value |
Number | 非負數數值代表實體的熱門程度,分數越高,表示人氣越高。 |
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"
}
]
}
}
相關網頁
請參閱下列網頁,瞭解與這些資源相關的主題: