Phần này cung cấp thông tin chi tiết về các thuộc tính mã đánh dấu nội dung cho loại thực thể BroadcastEvent. Để hiểu rõ hơn về mối quan hệ giữa các loại này, hãy xem các khái niệm về Sự kiện LiveTV.
Bảng quy cách BroadcastEvent
| Thuộc tính | Loại dự kiến | Mô tả |
|---|---|---|
@context |
Văn bản | Bắt buộc – Luôn đặt thành ["http://schema.org", {"@language": "xx"}]
|
@type |
Văn bản | Bắt buộc – Luôn đặt thành BroadcastEvent. |
@id |
URL | Bắt buộc – Giá trị nhận dạng của nội dung ở định dạng URI; ví dụ: https://example.com/1234abc.@id phải đáp ứng các yêu cầu sau:
url của một thực thể đáp ứng mọi yêu cầu về giá trị nhận dạng, nên bạn nên sử dụng url của thực thể làm @id. Hãy xem phần Giá trị nhận dạng để biết thêm thông tin chi tiết. |
name |
Văn bản | Bắt buộc – Tiêu đề của chương trình hoặc sự kiện. |
description |
Văn bản | Nội dung mô tả về chương trình hoặc sự kiện. Giới hạn 300 ký tự. Sử dụng một mảng để đưa nội dung mô tả bằng nhiều ngôn ngữ và độ dài. |
startDate |
Ngày | Bắt buộc – Thời gian bắt đầu của sự kiện ở định dạng ISO 8601 có múi giờ. |
endDate |
Ngày | Thời gian kết thúc của sự kiện ở định dạng ISO 8601 có múi giờ. |
publishedOn |
BroadcastService | Bắt buộc nếu có – Chỉ định thực thể BroadcastService phát sóng chương trình hoặc sự kiện này.Nếu nội dung được phát sóng trên một kênh truyền hình, thì bạn phải cung cấp thuộc tính này. Nếu nội dung không liên kết với kênh truyền hình nào, thì bạn không cần cung cấp thuộc tính này. |
publishedOn.@type |
Văn bản | Đặt thành BroadcastService. |
publishedOn.@id |
URL | @id của thực thể BroadcastService phát sóng chương trình hoặc sự kiện này. |
workPerformed |
CreativeWork (Tác phẩm sáng tạo) | Bắt buộc nếu có thể áp dụng – Sử dụng thuộc tính này khi nội dung thuộc một trong các loại thực thể sau: Movie, TVSeries và TVEpisode.Bạn nên thêm ít nhất một trong các loại thực thể sau vào BroadcastEvent:
|
workPerformed.@type |
Văn bản | Đặt thành Movie, TVSeries hoặc TVEpisode. |
workPerformed.@id |
URL | @id của thực thể nội dung. |
broadcastOfEvent |
SportsEvent | Bắt buộc nếu có thể áp dụng – Sử dụng thuộc tính này nếu nội dung là một sự kiện phát trực tiếp:
Bạn nên thêm ít nhất một trong các mục sau vào thực thể BroadcastEvent:
|
broadcastOfEvent.@type |
Văn bản | Đặt thành SportsEvent. |
broadcastOfEvent.@id |
URL | @id của thực thể sự kiện. Thực thể sự kiện phải có trong nguồn cấp dữ liệu và có @id khác với BroadcastEvent. |
location |
Text (Văn bản) hoặc Country (Quốc gia) | Bắt buộc nếu BroadcastEvent là SportsEvent, tức là có thuộc tính broadcastOfEvent – Quốc gia mà SportsEvent cơ bản có thể phát sóng. Trường này có thể là danh sách các quốc gia nếu nhiều quốc gia có thể phát sóng SportsEvent. |
videoFormat |
Văn bản | Định nghĩa chất lượng cao nhất được hỗ trợ trên dịch vụ phát sóng này; ví dụ:
|
contentToBeAnnounced |
Boolean | Bắt buộc nếu có thể áp dụng – Sử dụng thuộc tính này nếu bạn không biết nội dung tại thời điểm tạo nguồn cấp dữ liệu. Đặt thành true khi nhà cung cấp không có thông tin mới nhất về nội dung sẽ được phát sóng, nếu không thì đặt thành false.Bạn nên đặt ít nhất một trong các giá trị sau cho thực thể BroadcastEvent:
|
offAir |
Boolean | Bắt buộc nếu có – Sử dụng thuộc tính này nếu không có nội dung phát sóng theo lịch cho khung giờ. Bạn nên đưa ít nhất một trong các thuộc tính sau vào thực thể BroadcastEvent:
|
isLiveBroadcast |
Boolean | Đặt thành true nếu đây là một sự kiện trực tiếp; ví dụ: sự kiện thể thao hoặc buổi hoà nhạc. |
potentialAction |
WatchAction | Bắt buộc nếu có – Nếu nội dung được phát sóng dưới dạng sự kiện phát trực tiếp không có kênh (với contentToBeAnnounced được đặt thành false hoặc offAir được đặt thành false) , hãy sử dụng thuộc tính này để cung cấp đường liên kết sâu của sự kiện. |
identifier |
PropertyValue | Giá trị nhận dạng bên ngoài xác định nội dung phát sóng. Hãy xem phần Thuộc tính của giá trị nhận dạng để biết thông tin chi tiết.
|
contentRating |
Text (Văn bản) hoặc Rating (Mức phân loại) | Bắt buộc đối với nội dung người lớn, rất nên dùng cho các nội dung khác Tại sao? – Mức phân loại nội dung tổng thể của nội dung phát sóng. Nếu mức phân loại nội dung được cung cấp dưới dạng chuỗi văn bản, thì bạn có thể dùng 2 biến thể:
|
contentRating.author |
Tổ chức | Bắt buộc nếu contentRating sử dụng Rating – Tên của cơ quan phân loại. |
contentRating.ratingValue |
Văn bản | Bắt buộc nếu contentRating sử dụng Rating – Giá trị của mức phân loại. |
contentRating.advisoryCode |
Văn bản | Mã cảnh báo cho nội dung. Các giá trị được chấp nhận bao gồm D, FV, L, S và V. D = Dialogue (Lời thoại), FV = Fantasy Violence (Bạo lực trong bối cảnh giả tưởng), L = Language (Ngôn từ), S = Sexual Content (Nội dung tình dục), V = Violence (Bạo lực). |
Ví dụ
Một tập chương trình truyền hình được phát sóng trên mạng truyền hình Example TV (BroadcastService) từ 21:00 đến 21:30 ngày 12 tháng 10 năm 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"
}
]
}
}
}
Ví dụ minh hoạ việc sử dụng thuộc tính contentToBeAnnounced khi nội dung sẽ được phát sóng trên mạng truyền hình Example TV (BroadcastService) trong khoảng thời gian từ 21:00 đến 21:30 ngày 12 tháng 10 năm 2019 chưa được biết tại thời điểm tạo nguồn cấp dữ liệu:
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"
}
]
}
}
}
Mạng truyền hình Example TV(BroadcastService) ngừng phát sóng từ 12:00 đến 20:00 và phát sóng 1 chương trình tên là My favorite show từ 20:00 đến 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"
}
]
}
}
}
Các trang liên quan
Hãy xem các trang sau đây để biết các chủ đề liên quan đến những thuộc tính này: