Thuộc tính đánh dấu nội dung của sự kiện truyền hình trực tiếp

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

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"}]
  • Thay thế xx bằng mã ngôn ngữ của thực thể ở định dạng định dạng BCP 47, ví dụ: "en".
@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:
  • Độc đáo trên toàn cầu trong danh mục của bạn
  • Tĩnh; Mã này phải cố định và không thay đổi theo thời gian (ngay cả khi thuộc tính url của chương trình thay đổi). URL này sẽ được coi là một chuỗi mờ và không cần phải là một đường liên kết hoạt động.
  • Ở dạng Giá trị nhận dạng tài nguyên hợp nhất (URI)
  • Miền mà bạn dùng cho giá trị @id phải thuộc sở hữu của tổ chức của bạn.
url của một thực thể đáp ứng tất cả yêu cầu để có giá trị nhận dạng, nên bạn nên sử dụng url của một thực thể làm @id. Xem phần Identifier để 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. Limist dài 300 ký tự. Dùng một 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 kèm múi giờ.
endDate Ngày Thời gian kết thúc sự kiện ở định dạng ISO 8601 kèm 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 trên một kênh truyền hình, 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 bất kỳ kênh truyền hình nào, 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 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 là một trong các loại thực thể sau: Movie, TVSeriesTVEpisode.
Bạn nên bao gồm ít nhất một trong các loại thực thể sau:
    BroadcastEvent
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced được đặt thành true
  • offAir được đặt thành true
workPerformed.@type Văn bản Hãy đặ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 trực tiếp:
  • Đối với một sự kiện thể thao, thuộc tính này cần phải tham chiếu đến một thực thể SportsEvent.

Bạn nên sử dụng ít nhất một trong các thực thể BroadcastEvent sau đây:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced được đặt thành true
  • offAir được đặt thành true
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 Text (Văn bản) hoặc Country (Quốc gia) Bắt buộc nếu BroadcastEvent dành cho một SportsEvent, tức là có thuộc tính broadcastOfEvent – Quốc gia nơi SportsEvent cơ bản có thể được 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 Sự kiện thể thao.
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ụ:
  • "SD" cho độ phân giải chuẩn.
  • "HD" cho độ phân giải cao.
  • "2K" cho độ phân giải 2K.
  • "4K" cho độ phân giải 4K.
  • "8K" cho độ phân giải 8K.
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 cập nhật về nội dung sẽ được phát sóng, nếu không thì false.
Bạn nên bao gồm ít nhất một trong các loại sau:
    BroadcastEvent
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced được đặt thành true
  • offAir được đặt thành true
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 khung giờ đó.
Bạn nên sử dụng một BroadcastEvent thực thể ít nhất là một trong các loại sau:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced được đặt thành true
  • offAir được đặt thành true
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 trên kênh ít hơn (trong đó 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 đến sự kiện.
identifier PropertyValue Mã nhận dạng bên ngoài xác định nội dung truyền phát. Xem phần Thuộc tính giá trị nhận dạng để biết thông tin chi tiết.
  • Lưu ý: Loại thực thể BroadcastEvent chỉ chấp nhận các giá trị propertyID của TMS_ID hoặc TMS_ROOT_ID.
  • Bạn chỉ nên cung cấp thuộc tính này cho các trường hợp khi một thực thể Movie, TVSeries, TVEpisode hoặc SportsEvent cấp cao nhất có định dạng đầy đủ không được tham chiếu bằng thuộc tính workPerformed hoặc broadcastOfEvent.
  • Giá trị của thuộc tính phải phản ánh TMS_ID hoặc TMS_ROOT_ID của thực thể Movie, TVSeries, TVEpisode hoặc SportsEvent mà bạn nên tham chiếu thông qua thuộc tính workPerformed hoặc broadcastOfEvent.
  • TMS_ID được ưu tiên hơn giá trị TMS_ROOT_ID.
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 chung nội dung của chương trình phát sóng. Nếu mức phân loại nội dung được cung cấp ở dạng chuỗi văn bản, thì chúng tôi chấp nhận hai biến thể:
  • Tổ chức phân loại đã thêm một khoảng trắng ở giữa vào trước mức phân loại đó. Ví dụ: "PG-13" mức phân loại của cơ quan "MPAA" ở Hoa Kỳ phải được mô tả là "MPAA PG-13". Xem danh sách đại lý.
  • Giá trị "Xếp hạng KHÔNG BIẾT" (không phân biệt chữ hoa chữ thường) để cho biết bạn không biết mức phân loại của Bộ phim.
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 đ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) 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ụ minh hoạ việc sử dụng thuộc tính contentToBeAnnounced khi nội dung cần được phát sóng trên mạng truyền hình Ví dụ: truyền hình (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 không 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"
        }
      ]
    }
  }
}

Kênh của mạng truyền hình Example TV(BroadcastService) không phát sóng trong khoả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 chiều và 12 giờ trưa:

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"
        }
      ]
    }
  }
}

Hãy xem các trang sau để biết những chủ đề liên quan đến những tài sản này: