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 này, hãy xem lại các khái niệm về Sự kiện truyền hình trực tiếp.
Bảng thông số kỹ thuật BroadcastEvent
| Tài sản | Loại dự kiến | Nội dung 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 pháp nhân đáp ứng tất cả các yêu cầu về giá trị nhận dạng, nên bạn nên sử dụng url của pháp nhân làm @id. Hãy xem mục Giá trị nhận dạng để biết thêm 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. 300 ký tự limist. Sử dụng mảng để thêm 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 sự kiện ở định dạng ISO 8601 theo múi giờ. |
endDate |
Ngày | Thời gian kết thúc sự kiện ở định dạng ISO 8601 với múi giờ. |
publishedOn |
BroadcastService | Bắt buộc nếu có – Chỉ định thực thể BroadcastService sẽ phát chương trình hoặc sự kiện này.Nếu nội dung được phát trên một kênh truyền hình, thì bạn phải dùng thuộc tính này. Nếu nội dung không được liên kết với bất kỳ kênh truyền hình nào thì khô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 chương trình hoặc sự kiện này. |
workPerformed |
CreativeWork | Bắt buộc nếu có – Hãy 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 bao gồm ít nhất một trong các loại thực thể sau:
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 tài sản này nếu nội dung là sự kiện trực tiếp:
Thực thể BroadcastEvent nên có ít nhất một trong các trạng thái sau:
|
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 thực thể của BroadcastEvent. |
location |
Text (Văn bản) hoặc Country (Quốc gia) | Bắt buộc nếu BroadcastEvent dành cho một sự kiện SportsEvent, tức là có thuộc tính broadcastOfEvent – Quốc gia nơi có thể phát sóng sự kiện SportsEvent cơ bản. 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 | Độ phân giải 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ó – Sử dụng thuộc tính này nếu không xác định được 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ẽ phát sóng, nếu không thì false.Bạn nên cung cấp ít nhất một trong số các 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 nào được lên kế hoạch phát sóng trong khoảng thời gian đó. Bạn nên bao gồm ít nhất một trong các thực thể BroadcastEvent trong số:
|
isLiveBroadcast |
Boolean | Đặt thành true nếu đây là 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 dưới dạng sự kiện phát trực tiếp ít hơn trên 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ã bên ngoài xác định nội dung phát sóng. Hãy xem mục Thuộc tính giá trị nhận dạng để biết thông tin chi tiết.
|
contentRating |
Văn bản hoặc Xếp hạng | Bắt buộc đối với nội dung người lớn, đặc biệt nên dùng 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, hệ thống chấp nhận hai biến thể:
|
contentRating.author |
Văn bản hoặc 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 điểm xếp hạng. |
contentRating.advisoryCode |
Văn bản | Mã tư vấn cho nội dung. Các giá trị được chấp nhận bao gồm D, FV, L, S và V. D = Đối thoại, FV = Bạo lực ảo , L = Ngôn ngữ, S = Nội dung tình dục, V = 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) trong khoảng thời gian từ 9 giờ tối đến 9:30 tối 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ụ cho thấy việc sử dụng thuộc tính contentToBeAnnounced khi nội dung sẽ được phát trên mạng truyền hình Example TV (BroadcastService) trong khoảng thời gian từ 9 giờ tối đến 9:30 tối ngày 12 tháng 10 năm 2019 chưa được xác định 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) Kênh phát sóng trong khoảng thời gian từ 12:00 đến 20:00 và phát 1 chương trình có tên 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 tham khảo những trang sau đây để tìm hiểu những chủ đề liên quan đến những tài sản này: