本節提供 BroadcastEvent
實體類型內容標記屬性的詳細資料。如要進一步瞭解這兩種類型之間的關係,請參閱「直播電視事件」概念。
BroadcastEvent 規格表格
屬性 | 預期類型 | 說明 |
---|---|---|
@context |
文字 | 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
|
@type |
文字 | 必要 - 一律設為 BroadcastEvent 。 |
@id |
網址 | 必要 - URI 格式的內容 ID,例如 https://example.com/1234abc。@id 必須符合下列規定:
url 符合所有要求做為 ID,我們建議您使用實體的 url 做為 @id 。詳情請參閱「ID」一節。 |
name |
文字 | 必填 - 節目或活動的名稱。 |
description |
文字 | 節目或活動的說明。300 個字元的遮蔽物。您可以使用陣列,以多種語言和長度加入說明。 |
startDate |
日期 | 必要 - 活動的開始時間,採用 ISO 8601 格式,含時區。 |
endDate |
日期 | 活動的結束時間,採用 ISO 8601 格式,含時區。 |
publishedOn |
BroadcastService | 必要 (如適用) - 指定播出這個節目或活動的 BroadcastService 實體。如果內容是在電視頻道中播放,則必須提供這個屬性。如果內容未與任何電視頻道建立關聯,請勿提供這個屬性。 |
publishedOn.@type |
文字 | 請設為 BroadcastService 。 |
publishedOn.@id |
網址 | 播送這個節目或活動的 BroadcastService 實體 @id 。 |
workPerformed |
CreativeWork | 必要 (如適用) - 如果內容是下列其中一種實體類型,請使用這項屬性:Movie 、TVSeries 和 TVEpisode 。強烈建議 BroadcastEvent 實體包含至少下列其中一項:
|
workPerformed.@type |
文字 | 設為 Movie 、TVSeries 或 TVEpisode 。 |
workPerformed.@id |
網址 | 內容實體的 @id 。 |
broadcastOfEvent |
SportsEvent | 必要 (如適用) - 如果內容為現場活動,請使用這項屬性:
強烈建議您在 BroadcastEvent 實體中加入至少下列其中一項:
|
broadcastOfEvent.@type |
文字 | 請設為 SportsEvent 。 |
broadcastOfEvent.@id |
網址 | 事件實體的 @id 。事件實體必須存在於動態饋給中,且 @id 與 BroadcastEvent 不同。 |
location |
Text 或 Country | 如果 BroadcastEvent 適用於 SportsEvent,則此為必要屬性,例如擁有 broadcastOfEvent 屬性:基礎 SportsEvent 可在哪個國家/地區播送。如果有多個國家/地區可以播送 SportsEvent,請在這個欄位中列出這個欄位。 |
videoFormat |
文字 | 此廣播服務支援的最高畫質定義;例如
|
contentToBeAnnounced |
布林值 | 必要 (如適用) - 如果建立動態饋給時不知道內容,請使用這項屬性。 如果供應商沒有關於即將廣播內容的最新資訊,請設為 true ,否則請設為 false 。強烈建議 BroadcastEvent 實體包含至少下列其中一項:
|
offAir |
布林值 | 必要 (如適用) - 如果時段沒有預定的內容廣播,請使用這項屬性。 強烈建議 BroadcastEvent 實體至少加入下列其中一項:
|
isLiveBroadcast |
布林值 | 如果是現場活動 (例如體育賽事或音樂會),請設為 true 。 |
potentialAction |
WatchAction | 必要 (如適用) - 如果內容是以較少頻道的直播活動形式播送 (contentToBeAnnounced 設為 false 或 offAir 設為 false ),請使用這個屬性來提供事件的深層連結。 |
identifier |
PropertyValue | 可識別廣播內容的外部 ID。詳情請參閱「ID 屬性」一節。
|
contentRating |
Text 或 Rating | 這是成人內容的必填屬性,強烈建議提供原因- 廣播內容的整體內容分級。如果內容分級是以文字字串的形式表示,系統接受兩種變化版本:
|
contentRating.author |
Text 或 Organization | 如果 contentRating 使用 Rating ,則為必填 - 分級機構的名稱。 |
contentRating.ratingValue |
文字 | 如果 contentRating 使用 Rating ,則為必要欄位 - 評分的值。 |
contentRating.advisoryCode |
文字 | 內容的建議代碼。接受的值包括 D、FV、L、S 和 V。D = Dialogue、FV = 虛構暴力行為 、L = 語言,S = 色情內容,V = 暴力。 |
示例
一個電視劇集是在 2019 年 10 月 12 日晚上 9 點到晚上 9 點 30 分之間,透過 Example TV (BroadcastService
) 電視聯播網播送:
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"
}
]
}
}
}
範例:建立動態饋給時,若無法得知在 2019 年 10 月 12 日下午 9 點到晚上 9 點 30 分之間,在電視聯播網 Example TV (BroadcastService
) 上播送的內容使用 contentToBeAnnounced
屬性:
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 點到 8 點之間播出,並於晚上 8 點到 12 點之間播送名為 My favorite show
的節目:
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"
}
]
}
}
}
相關網頁
請參閱下列網頁,瞭解與這些房源相關的主題: