Phần này cung cấp thông tin chi tiết về các thuộc tính đá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 sự kiện này, hãy xem lại các khái niệm về Sự kiện LiveTV.
Bảng thông số kỹ thuật của 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:/
|
@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 tất cả các yêu cầu đối với 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 – Tên chương trình hoặc sự kiện. |
description |
Văn bản | Nội dung mô tả chương trình hoặc sự kiện. Giới hạn 300 ký tự. Sử dụng một mảng để đưa vào 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 kèm theo múi giờ. |
endDate |
Ngày | Thời gian kết thúc sự kiện ở định dạng ISO 8601 kèm theo 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 sử dụng thuộc tính này. Nếu nội dung không liên kết với bất kỳ kênh truyền hình nào, đừng 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ó) – 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 những thuộc tính sau vào thực thể 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ó – Sử dụng thuộc tính này nếu nội dung là sự kiện phát trực tiếp:
Bạn nên thêm ít nhất một trong những thuộc tính 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 tồn tại trong nguồn cấp dữ liệu và có @id khác với BroadcastEvent. |
location |
Văn bản hoặc Quốc gia | Bắt buộc nếu BroadcastEvent là của SportsEvent, tức là có thuộc tính broadcastOfEvent – Quốc gia mà SportsEvent cơ bản có thể được phát sóng. Trường này có thể là danh sách quốc gia nếu nhiều quốc gia có thể phát sóng SportsEvent. |
videoFormat |
Văn bản | Độ phân giải chất lượng cao nhất được hỗ trợ trên dịch vụ truyền hình này; ví dụ:
|
contentToBeAnnounced |
Boolean | Bắt buộc nếu có – Sử dụng thuộc tính này nếu nội dung không xác định 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 thêm ít nhất một trong các thuộc tính sau vào 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 thêm ít nhất một trong những thuộc tính sau vào thực thể BroadcastEvent:
|
isLiveBroadcast |
Boolean | Đặt thành true nếu đây là sự kiện phát trực tiếp; ví dụ: sự kiện thể thao hoặc buổi hòa 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 | Mã 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 giá trị nhận dạng để biết thông tin chi tiết.
|
contentRating |
Text (Văn bản) hoặc Rating (Điểm xếp hạng) | Bắt buộc đối với nội dung người lớn, bạn nên làm như vậy đối với 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ì hệ thống sẽ chấp nhận hai biến thể:
|
contentRating.author |
Tổ chức | Bắt buộc nếu contentRating sử dụng Rating – Tên của công ty xếp hạng. |
contentRating.ratingValue |
Văn bản | Bắt buộc nếu contentRating sử dụng Rating – Giá trị của điểm xếp hạng. |
contentRating.advisoryCode |
Văn bản | Mã cảnh báo về nội dung. Các giá trị được chấp nhận bao gồm D, FV, L, S và V. D = Nội dung hội thoại, FV = Nội dung bạo lực giả tưởng, L = Ngôn từ, S = Nội dung tình dục, V = Nội dung bạo lực. |
Ví dụ
Một tập phim truyền hình được phát sóng trên mạng truyền hình Example TV (BroadcastService) từ 9 giờ đến 9 giờ 30 phút ngày 12 tháng 10 năm 2019:
{
"@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"
}
}
{
"@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ạ cách 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) 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:
{
"@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
}
{
"@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) Kênh không phát sóng từ 12 giờ trưa đến 8 giờ tối và phát sóng 1 chương trình có tên My favorite show từ 8 giờ tối đến 12 giờ trưa:
{
"@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"
},
}
{
"@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 tài sản này: