Thuộc tính đánh dấu nội dung của chương trình truyền hình

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 các loại thực thể TVSeries, TVEpisodeTVSeason.

Bạn không bắt buộc phải cung cấp TVSeason dưới dạng một thực thể đầy đủ. Xem phần Mối quan hệ với TV Series, TVSeason và TVEpisode để biết thông tin chi tiết.

Bảng thông số kỹ thuật

TVSeries

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"}]
  • Địa điểm" xx inch thể hiện ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Mỗi ngữ cảnh của thực thể gốc phải có @language được đặt thành mã ngôn ngữ thích hợp ở định dạng định dạng BCP 47. Ví dụ: Nếu bạn đặt ngôn ngữ thành tiếng Tây Ban Nha, thì tên đó được giả định là bằng tiếng Tây Ban Nha ngay cả khi ngôn ngữ phụ đề/lồng tiếng là tiếng Anh.
@type Văn bản Bắt buộc – Luôn đặt thành TVSeries.
@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
  • 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.
url URL Bắt buộcURL chính tắc của nội dung mà Google sử dụng để so khớp nội dung trong nguồn cấp dữ liệu của bạn với nội dung trong cơ sở dữ liệu của Google.
url phải đáp ứng các yêu cầu sau:
  • url phải là duy nhất trên toàn hệ thống
  • url phải chứa một URL chính tắc đang hoạt động mà Google có thể thu thập dữ liệu.
Để biết đường liên kết sâu của chế độ phát, hãy xem thuộc tính urlTemplate của đối tượng target.
name Văn bản Bắt buộc – Tên của chương trình.
  • Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Xem ví dụ về Nhiều khu vực và ngôn ngữ.
  • Xin lưu ý rằng hệ thống chỉ hỗ trợ một tên cho mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia).
titleEIDR Văn bản Rất nên dùng Tại sao? - Giá trị nhận dạng EIDR (Sổ đăng ký mã nhận dạng nội dung giải trí) thể hiện ở cấp độ chung/trừu tượng nhất, một tác phẩm phim hoặc chương trình truyền hình.

Ví dụ: tiêu đề EIDR của loạt phim truyền hình có tên là "Trò chơi vương quyền" là "10.5240/C1B5-3BA1-8991-A571-8472-W".
potentialAction WatchAction Bắt buộc nếu cóĐối tượng đánh dấu Hành động cung cấp thông tin chi tiết về hành động đó.
  • Nếu nội dung đó có trên Video theo yêu cầu (VoD), thì bạn phải cung cấp thuộc tính này; đối tượng đánh dấu Hành động cần cung cấp đường liên kết sâu của nội dung.
  • Nếu nội dung đó có trên một kênh Truyền hình trực tuyến, thì thuộc tính này là không bắt buộc; thực thể BroadcastService được liên kết sẽ cung cấp đường liên kết sâu của kênh.
  • TVSeries có thể hoạt động trên cả VoD và LiveTV.
Sử dụng một mảng để chỉ định nhiều đường liên kết sâu ở nhiều khu vực. Xem ví dụ về Nhiều khu vực và ngôn ngữ.
sameAs URL Rất nên dùng Tại sao? URL tới một trang web tham khảo có thể xác định chương trình đó; ví dụ: trang Wikipedia của chương trình. Thuộc tính này phải khác với thuộc tính url.
inLanguage Văn bản Ngôn ngữ gốc của bộ sách ở định dạng BCP 47.
genre Văn bản Danh sách theo thứ tự gồm tất cả thể loại có liên quan. Ví dụ : ["Action", "Fashion", "Environment", "Football"]
keywords Văn bản Từ khoá hoặc thẻ dùng để mô tả nội dung này. Một loạt từ khoá cũng được cho phép. Ví dụ: ["đặc điểm, tiểu sử"] có thể là một mảng từ khoá để mô tả nội dung.
releasedEvent PublicationEvent, FeaturedEvent hoặc ExclusiveEvent Rất nên dùng Tại sao?PublicationEvent dùng để chỉ định nhà xuất bản phát hành nội dung gốc (toàn cầu hoặc địa phương), chẳng hạn như ngày phát hành phim ở rạp.

Ngoài ra, hãy sử dụng FeaturedEvent để cho biết dịch vụ của bạn sẽ tiếp thị nội dung này dưới dạng bản gốc, nội dung nổi bật, đặc biệt, v.v.

ExclusiveEvent xác định rằng dịch vụ của bạn có quyền phân phối độc quyền và bao gồm cả vị trí và thời điểm phát hành.

Hãy xem phần ví dụ để biết chi tiết và ví dụ.
releasedEvent.@type Văn bản Bắt buộc – Đảm bảo luôn đặt thuộc tính này thành một trong các giá trị sau:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Quốc gia Bắt buộc – Các khu vực liên kết với sự kiện này.

Đối với PublicationEvent, đây là khu vực xuất bản nội dung.

Đối với FeaturedEventExclusiveEvent, đây là khu vực nơi nội dung được xuất hiện nổi bật hoặc độc quyền.

Sử dụng mã ISO 3166 cho các quốc gia. Để biểu thị ở mọi nơi trên thế giới, hãy đặt thành EARTH.
releasedEvent.startDate Date (Ngày tháng) hoặc DateTime (Ngày giờ) Đề xuấtBắt buộc đối với ExclusiveEvent – Ngày bắt đầu ấn bản của thực thể.

Đối với PublicationEvent, đây là ngày phát hành đầu tiên của thực thể này, chẳng hạn như ngày phát hành phim lần đầu tại rạp.

Đối với ExclusiveEventFeaturedEvent, đây là ngày bắt đầu mà thực thể độc quyền hoặc xuất hiện nổi bật.
releasedEvent.endDate Date (Ngày tháng) hoặc DateTime (Ngày giờ) Đề xuấtBắt buộc đối với ExclusiveEvent – Trường này chỉ áp dụng cho loại ExclusiveEventFeaturedEvent.

Đối với ExclusiveEvent, giá trị này thể hiện ngày các quyền đối với nội dung hết hạn.

Đối với FeaturedEvent, đây là ngày cuối cùng nhà cung cấp giới thiệu thực thể đó.

Nếu nội dung vĩnh viễn độc quyền hoặc nổi bật, hãy đặt endDate thành 20 năm kể từ ngày hiện tại.
releasedEvent.publishedBy Organization (Tổ chức) hoặc Person (Người) Không bắt buộc – Tổ chức hoặc cá nhân đã xuất bản thực thể này.
description Văn bản Rất nên dùng Tại sao? Bản tóm tắt chương trình. Nên ưu tiên bản tóm tắt cốt truyện so với bản tóm tắt dữ kiện. Giới hạn 300 ký tự.
actor Person hoặc PerformingGroup hoặc PerformanceRole Rất nên dùng Tại sao? Một nhóm dàn diễn viên trong loạt phim. Xem hướng dẫn lập mô hình tại đây.
director Person (Người) Rất nên dùng Tại sao? Đạo diễn của chương trình.
producer Organization (Tổ chức) hoặc Person (Người) Rất nên dùng Tại sao? (Các) nhà sản xuất của chương trình.
image ImageObject (Đối tượng hình ảnh) Bắt buộc đối với Google TV – Hình ảnh liên quan đến TV Series. Để biết thêm thông tin chi tiết về các thuộc tính bắt buộc và không bắt buộc phải bao gồm với image, hãy xem bài viết Thuộc tính hình ảnh.
trailer.description Văn bản Nội dung mô tả về đoạn giới thiệu. Xem ví dụ về Đoạn giới thiệu.
trailer.inLanguage Văn bản Ngôn ngữ của đoạn giới thiệu ở định dạng BCP 47.
trailer.url URL URL của một đoạn giới thiệu được lưu trữ công khai và do các hãng sản xuất hoặc nguồn được uỷ quyền tương ứng lưu trữ.
trailer.regionsAllowed Địa điểm Các khu vực cho phép nội dung nghe nhìn này. Nếu bạn không chỉ định, thì thuộc tính này được coi là được cho phép ở mọi nơi. Hãy chỉ định các quốc gia theo định dạng ISO 3166.
identifier PropertyValue Rất nên dùng Tại sao? - Mã nhận dạng bên ngoài hoặc mã nhận dạng khác xác định rõ ràng thực thể này. Bạn được phép sử dụng nhiều giá trị nhận dạng. Xem phần Thuộc tính giá trị nhận dạng để biết thông tin chi tiết.
popularityScore PopularityScoreSpecification Rất nên dùng Tại sao? Điểm số mà Google sử dụng cùng với các tín hiệu khác để xác định nội dung nghe nhìn sẽ phát cho người dùng. Điểm số này thể hiện mức độ phổ biến của nội dung so với những nội dung khác trong danh mục của bạn; do đó, thang điểm cần nhất quán trên các nguồn cấp dữ liệu của bạn, giữa tất cả các thực thể trong danh mục của bạn. Theo mặc định, điểm mức độ phổ biến của một thực thể được đặt là 0.
popularityScore.@type Văn bản Luôn đặt thành PopularityScoreSpecification.
popularityScore.value Number Một giá trị số không âm cho biết mức độ phổ biến của thực thể; điểm số càng cao thì mức độ phổ biến càng cao.
popularityScore.eligibleRegion Quốc gia (Các) khu vực có áp dụng điểm số phổ biến này. Nếu điểm phổ biến có thể áp dụng trên toàn cầu, hãy đặt thành EARTH. Theo mặc định, thuộc tính này được đặt thành EARTH.
Note: Mức độ phổ biến theo ngôn ngữ được ưu tiên hơn mức độ phổ biến trên toàn cầu (earth)
review Bài đánh giá Xem lại mức phân loại của chương trình truyền hình dài tập
review.reviewRating Điểm xếp hạng Bắt buộc nếu bạn cung cấp review Thuộc tính này dùng để xác định điểm xếp hạng trong bài đánh giá.
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, nếu không nên dùng – Mức phân loại nội dung tổng thể. 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ụ: "TV-MA" mức phân loại của công ty quảng cáo "TVPG" ở Hoa Kỳ phải được mô tả là "TVPG TV-MA". 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 điểm xếp hạng của nội dung đó.
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. Xem trang Cơ quan phân loại nội dung để biết danh sách các cơ quan phân loại được chấp nhận
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.

TVEpisode

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"}]
  • Địa điểm" xx inch thể hiện ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Mỗi ngữ cảnh của thực thể gốc phải có @language được đặt thành mã ngôn ngữ thích hợp ở định dạng định dạng BCP 47. Ví dụ: Nếu bạn đặt ngôn ngữ thành tiếng Tây Ban Nha, thì tên đó được giả định là bằng tiếng Tây Ban Nha ngay cả khi ngôn ngữ phụ đề/lồng tiếng là tiếng Anh.
@type Văn bản Bắt buộc – Luôn đặt thành TVEpisode.
@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
  • 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.
url URL Bắt buộcURL chính tắc của nội dung mà Google sử dụng để so khớp nội dung trong nguồn cấp dữ liệu của bạn với nội dung trong cơ sở dữ liệu của Google.
url phải đáp ứng các yêu cầu sau:
  • url phải là duy nhất trên toàn hệ thống
  • url phải chứa một URL chính tắc đang hoạt động mà Google có thể thu thập dữ liệu.
Để biết đường liên kết sâu của chế độ phát, hãy xem thuộc tính urlTemplate của đối tượng target.
name Văn bản Bắt buộc – Tên tập đó.
  • Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Xem ví dụ về Biểu diễn bằng nhiều ngôn ngữ.
  • Xin lưu ý rằng hệ thống chỉ hỗ trợ một tên cho mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia).
titleEIDR Văn bản Rất nên dùng Tại sao? - Giá trị nhận dạng EIDR (Sổ đăng ký mã nhận dạng nội dung giải trí) thể hiện ở cấp độ chung/trừu tượng nhất, một tác phẩm phim hoặc chương trình truyền hình.

Ví dụ: tiêu đề EIDR cho tập đầu tiên của phần đầu tiên của TV Series có tên là "Game of Thrones" (Trò chơi vương quyền) là "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
editEIDR Văn bản Rất nên dùng Tại sao? – Mã nhận dạng EIDR (Sổ đăng ký mã nhận dạng nội dung giải trí) đại diện cho bản chỉnh sửa / ấn bản cụ thể cho tác phẩm phim hoặc chương trình truyền hình.

Ví dụ: tập đầu tiên của phần đầu tiên của TV Series có tên là "Trò chơi vương quyền", có tiêu đề EIDR là "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", có một nội dung chỉnh sửa, ví dụ: "10.5240/FB97-C847-2969-D0AB-ECD1-C".

titleEIDR Thuộc tính bắt buộc khi chỉnh sửa EIDR được cung cấp.
inLanguage Văn bản Ngôn ngữ gốc của bộ sách ở định dạng BCP 47.
episodeNumber Số nguyên Bắt buộc – Số cho biết vị trí của tập này theo thứ tự các tập trong một phần. episodeNumber cần khởi động lại cho từng phần; tức là tập đầu tiên của mỗi phần phải là 1.
partOfSeason TVSeason Bắt buộc – Phần chương trình truyền hình chứa tập này.

Ngay cả khi TVEpisode không có TVSeason tương ứng, bạn vẫn cần cung cấp thuộc tính partOfSeason.@idpartOfSeason.seasonNumber. Cách giải quyết là:
  • Lấy partofSeries.@id (ví dụ: http://www.example.com/my_favorite_tv_show) và đính kèm một trường truy vấn phần giữ chỗ (ví dụ: ?season1) để tạo một partOfSeason.@id duy nhất (ví dụ: http://www.example.com/my_favorite_tv_show?season1).
  • Đặt partOfSeason.seasonNumber thành 1.
partOfSeason.@type Văn bản Bắt buộc – Luôn đặt thành TVSeason.
partOfSeason.@id URL Bắt buộc@id của TVSeason chứa tập này.
partOfSeason.seasonNumber Số nguyên Bắt buộc – Số cho biết vị trí của phần này theo thứ tự các phần trong chương trình truyền hình dài tập.
partOfSeries TVSeries Bắt buộc – Chương trình truyền hình dài tập có tập này.
partOfSeries.@type Văn bản Bắt buộc – Luôn đặt thành TVSeries.
partOfSeries.@id URL Bắt buộc@id của TVSeries chứa tập này.
partOfSeries.name Văn bản Bắt buộc – Tên của chương trình truyền hình dài tập.
partOfSeries.sameAs Văn bản URL tới một trang web tham khảo có thể xác định chương trình đó; ví dụ: trang Wikipedia của chương trình. Thuộc tính này phải khác với thuộc tính url.
potentialAction WatchAction Bắt buộc nếu cóĐối tượng đánh dấu Hành động cung cấp thông tin chi tiết về hành động đó.
  • Nếu nội dung đó có trên Video theo yêu cầu (VoD), thì bạn phải cung cấp thuộc tính này; đối tượng đánh dấu Hành động cần cung cấp đường liên kết sâu của nội dung.
  • Nếu nội dung đó có trên một kênh Truyền hình trực tuyến, thì thuộc tính này là không bắt buộc; thực thể BroadcastService được liên kết sẽ cung cấp đường liên kết sâu của kênh.
  • TVEpisode có thể hoạt động trên cả VoD và LiveTV.
Sử dụng một mảng để chỉ định nhiều đường liên kết sâu ở nhiều khu vực. Xem ví dụ về Nhiều khu vực và ngôn ngữ.
sameAs Rất nên dùng Tại sao? URL URL tới một trang web tham khảo có thể xác định tập đó; trang Wikipedia của tập đó. Thuộc tính này phải khác với thuộc tính url.
duration Thời lượng Thời gian chạy của tập ở định dạng ISO 8601. Vui lòng sử dụng định dạng: "PT00H00M".
releasedEvent PublicationEvent, FeaturedEvent hoặc ExclusiveEvent Rất nên dùng Tại sao?PublicationEvent dùng để chỉ định nhà xuất bản phát hành nội dung gốc (toàn cầu hoặc địa phương), chẳng hạn như ngày phát hành phim ở rạp.

Ngoài ra, hãy sử dụng FeaturedEvent để cho biết dịch vụ của bạn sẽ tiếp thị nội dung này dưới dạng bản gốc, nội dung nổi bật, đặc biệt, v.v.

ExclusiveEvent xác định rằng dịch vụ của bạn có quyền phân phối độc quyền và bao gồm cả vị trí và thời điểm phát hành.

Hãy xem phần ví dụ để biết chi tiết và ví dụ.
releasedEvent.@type Văn bản Bắt buộc – Đảm bảo luôn đặt thuộc tính này thành một trong các giá trị sau:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Quốc gia Bắt buộc – Các khu vực liên kết với sự kiện này.

Đối với PublicationEvent, đây là khu vực xuất bản nội dung.

Đối với FeaturedEventExclusiveEvent, đây là khu vực nơi nội dung được xuất hiện nổi bật hoặc độc quyền.

Sử dụng mã ISO 3166 cho các quốc gia. Để biểu thị ở mọi nơi trên thế giới, hãy đặt thành EARTH.
releasedEvent.startDate Date (Ngày tháng) hoặc DateTime (Ngày giờ) Đề xuấtBắt buộc đối với ExclusiveEvent – Ngày bắt đầu ấn bản của thực thể.

Đối với PublicationEvent, đây là ngày phát hành đầu tiên của thực thể này, chẳng hạn như ngày phát hành phim lần đầu tại rạp.

Đối với ExclusiveEventFeaturedEvent, đây là ngày bắt đầu mà thực thể độc quyền hoặc xuất hiện nổi bật.
releasedEvent.endDate Date (Ngày tháng) hoặc DateTime (Ngày giờ) Đề xuấtBắt buộc đối với ExclusiveEvent – Trường này chỉ áp dụng cho loại ExclusiveEventFeaturedEvent.

Đối với ExclusiveEvent, giá trị này thể hiện ngày các quyền đối với nội dung hết hạn.

Đối với FeaturedEvent, đây là ngày cuối cùng nhà cung cấp giới thiệu thực thể đó.

Nếu nội dung vĩnh viễn độc quyền hoặc nổi bật, hãy đặt endDate thành 20 năm kể từ ngày hiện tại.
releasedEvent.publishedBy Organization (Tổ chức) hoặc Person (Người) Không bắt buộc – Tổ chức hoặc cá nhân đã xuất bản thực thể này.
description Văn bản Rất nên dùng Tại sao? Bản tóm tắt về tập này. Nên ưu tiên bản tóm tắt cốt truyện so với bản tóm tắt dữ kiện. Giới hạn 300 ký tự.
genre Văn bản Danh sách theo thứ tự gồm tất cả thể loại có liên quan. Ví dụ : ["Action", "Fashion", "Environment", "Football"]
keywords Văn bản Từ khoá hoặc thẻ dùng để mô tả nội dung này. Một loạt từ khoá cũng được cho phép. Ví dụ: ["đặc điểm, tiểu sử"] có thể là một mảng từ khoá để mô tả nội dung.
actor Person hoặc PerformingGroup hoặc PerformanceRole Rất nên dùng Tại sao? Một mảng gồm dàn diễn viên của tập phim. Xem hướng dẫn lập mô hình tại đây.
director Person (Người) Rất nên dùng Tại sao? Đạo diễn của tập phim.
producer Organization (Tổ chức) hoặc Person (Người) Rất nên dùng Tại sao? (Các) nhà sản xuất của phần đó.
image ImageObject (Đối tượng hình ảnh) Lý do nên dùng Tại sao? trên Google TV – Nhiều hình ảnh liên quan đến tập phim truyền hình. Để biết thêm thông tin chi tiết về các thuộc tính bắt buộc và không bắt buộc phải bao gồm với image, hãy xem bài viết Thuộc tính hình ảnh.
trailer.description Văn bản Nội dung mô tả về đoạn giới thiệu. Xem ví dụ về Đoạn giới thiệu.
trailer.inLanguage Văn bản Ngôn ngữ của đoạn giới thiệu ở định dạng BCP 47.
trailer.url URL URL của một đoạn giới thiệu được lưu trữ công khai và do các hãng sản xuất hoặc nguồn được uỷ quyền tương ứng lưu trữ.
trailer.regionsAllowed Địa điểm Các khu vực cho phép nội dung nghe nhìn này. Nếu bạn không chỉ định, thì thuộc tính này được coi là được cho phép ở mọi nơi. Hãy chỉ định các quốc gia theo định dạng ISO 3166.
review Bài đánh giá Xem lại mức phân loại của tập chương trình truyền hình
review.reviewRating Điểm xếp hạng Bắt buộc nếu bạn cung cấp review Thuộc tính này dùng để xác định điểm xếp hạng trong bài đánh giá.
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, nếu không nên dùng – Mức phân loại nội dung tổng thể. 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ụ: "TV-MA" mức phân loại của công ty quảng cáo "TVPG" ở Hoa Kỳ phải được mô tả là "TVPG TV-MA". 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 điểm xếp hạng của nội dung đó.
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. Xem trang Cơ quan phân loại nội dung để biết danh sách các cơ quan phân loại được chấp nhận
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.
identifier PropertyValue Rất nên dùng Tại sao? - Mã nhận dạng bên ngoài hoặc mã nhận dạng khác xác định rõ ràng thực thể này. Bạn được phép sử dụng nhiều giá trị nhận dạng. Xem phần Thuộc tính giá trị nhận dạng để biết thông tin chi tiết.
popularityScore PopularityScoreSpecification Rất nên dùng Tại sao? Điểm số mà Google sử dụng cùng với các tín hiệu khác để xác định nội dung nghe nhìn sẽ phát cho người dùng. Điểm số này thể hiện mức độ phổ biến của nội dung so với những nội dung khác trong danh mục của bạn; do đó, thang điểm cần nhất quán trên các nguồn cấp dữ liệu của bạn, giữa tất cả các thực thể trong danh mục của bạn. Theo mặc định, điểm mức độ phổ biến của một thực thể được đặt là 0.
popularityScore.@type Văn bản Luôn đặt thành PopularityScoreSpecification.
popularityScore.value Number Một giá trị số không âm cho biết mức độ phổ biến của thực thể; điểm số càng cao thì mức độ phổ biến càng cao.
popularityScore.eligibleRegion Quốc gia (Các) khu vực có áp dụng điểm số phổ biến này. Nếu điểm phổ biến có thể áp dụng trên toàn cầu, hãy đặt thành EARTH. Theo mặc định, thuộc tính này được đặt thành EARTH.
Note: Mức độ phổ biến theo ngôn ngữ được ưu tiên hơn mức độ phổ biến trên toàn cầu (earth)

TVSeason

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"}]
  • Địa điểm" xx inch thể hiện ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Mỗi ngữ cảnh của thực thể gốc phải có @language được đặt thành mã ngôn ngữ thích hợp ở định dạng định dạng BCP 47. Ví dụ: Nếu bạn đặt ngôn ngữ thành tiếng Tây Ban Nha, thì tên đó được giả định là bằng tiếng Tây Ban Nha ngay cả khi ngôn ngữ phụ đề/lồng tiếng là tiếng Anh.
@type Văn bản Bắt buộc – Luôn đặt thành TVSeason.
@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
  • 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.
url URL Bắt buộcURL chính tắc của nội dung mà Google sử dụng để so khớp nội dung trong nguồn cấp dữ liệu của bạn với nội dung trong cơ sở dữ liệu của Google.
url phải đáp ứng các yêu cầu sau:
  • url phải là duy nhất trên toàn hệ thống
  • url phải chứa một URL chính tắc đang hoạt động mà Google có thể thu thập dữ liệu.
Để biết đường liên kết sâu của chế độ phát, hãy xem thuộc tính urlTemplate của đối tượng target.
name Văn bản Bắt buộc – Tên của phần chương trình truyền hình này.
  • Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Xem ví dụ về Biểu diễn bằng nhiều ngôn ngữ.
  • Xin lưu ý rằng hệ thống chỉ hỗ trợ một tên cho mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia).
titleEIDR Văn bản Rất nên dùng Tại sao? - Giá trị nhận dạng EIDR (Sổ đăng ký mã nhận dạng nội dung giải trí) thể hiện ở cấp độ chung/trừu tượng nhất, một tác phẩm phim hoặc chương trình truyền hình.

Ví dụ: tiêu đề EIDR cho phần đầu tiên của TV Series có tên là "Trò chơi vương quyền" là "10.5240/FD91-C72C-4161-FCBA-058B-1".
seasonNumber Số nguyên Bắt buộc – Số cho biết vị trí của phần này theo thứ tự các phần trong chương trình truyền hình dài tập.
partOfSeries TVSeries Bắt buộc – Phim truyền hình dài tập có phần này.
partOfSeries.@type Văn bản Bắt buộc – Luôn đặt thành TVSeries.
partOfSeries.@id URL Bắt buộc@id của TVSeries có phần này.
partOfSeries.name Văn bản Bắt buộc – Tên của chương trình truyền hình dài tập.
partOfSeries.sameAs Văn bản URL tới một trang web tham khảo có thể xác định chương trình đó; ví dụ: trang Wikipedia của chương trình. Thuộc tính này phải khác với thuộc tính url.
potentialAction WatchAction Bắt buộc nếu cóĐối tượng đánh dấu Hành động cung cấp thông tin chi tiết về hành động đó.
  • Nếu nội dung đó có trên Video theo yêu cầu (VoD), thì bạn phải cung cấp thuộc tính này; đối tượng đánh dấu Hành động cần cung cấp đường liên kết sâu của nội dung.
  • Nếu nội dung đó có trên một kênh Truyền hình trực tuyến, thì thuộc tính này là không bắt buộc; thực thể BroadcastService được liên kết sẽ cung cấp đường liên kết sâu của kênh.
  • TVSeason có thể hoạt động trên cả VoD và LiveTV.
Sử dụng một mảng để chỉ định nhiều đường liên kết sâu ở nhiều khu vực. Xem ví dụ về Nhiều khu vực và ngôn ngữ.
sameAs URL Rất nên dùng Tại sao? URL tới trang web tham khảo có thể xác định phần; ví dụ: trang Wikipedia của mùa đó. Thuộc tính này phải khác với thuộc tính url.
releasedEvent PublicationEvent, FeaturedEvent hoặc ExclusiveEvent Rất nên dùng Tại sao?PublicationEvent dùng để chỉ định nhà xuất bản phát hành nội dung gốc (toàn cầu hoặc địa phương), chẳng hạn như ngày phát hành phim ở rạp chiếu gốc.

Ngoài ra, hãy sử dụng FeaturedEvent để cho biết dịch vụ của bạn sẽ tiếp thị nội dung này dưới dạng bản gốc, nội dung nổi bật, đặc biệt, v.v.

ExclusiveEvent xác định rằng dịch vụ của bạn có quyền phân phối độc quyền và bao gồm cả vị trí và thời điểm phát hành.

Hãy xem phần ví dụ để biết chi tiết và ví dụ.
releasedEvent.@type Văn bản Bắt buộc – Đảm bảo luôn đặt thuộc tính này thành một trong các giá trị sau:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Quốc gia Bắt buộc – Các khu vực liên kết với sự kiện này.

Đối với PublicationEvent, đây là khu vực xuất bản nội dung.

Đối với FeaturedEventExclusiveEvent, đây là khu vực nơi nội dung được xuất hiện nổi bật hoặc độc quyền.

Sử dụng mã ISO 3166 cho các quốc gia. Để biểu thị ở mọi nơi trên thế giới, hãy đặt thành EARTH.
releasedEvent.startDate Date (Ngày tháng) hoặc DateTime (Ngày giờ) Đề xuấtBắt buộc đối với ExclusiveEvent – Ngày bắt đầu ấn bản của thực thể.

Đối với PublicationEvent, đây là ngày phát hành đầu tiên của thực thể này, chẳng hạn như ngày phát hành phim lần đầu tại rạp.

Đối với ExclusiveEventFeaturedEvent, đây là ngày bắt đầu mà thực thể độc quyền hoặc xuất hiện nổi bật.
releasedEvent.endDate Date (Ngày tháng) hoặc DateTime (Ngày giờ) Đề xuấtBắt buộc đối với ExclusiveEvent – Trường này chỉ áp dụng cho loại ExclusiveEventFeaturedEvent.

Đối với ExclusiveEvent, giá trị này thể hiện ngày các quyền đối với nội dung hết hạn.

Đối với FeaturedEvent, đây là ngày cuối cùng nhà cung cấp giới thiệu thực thể đó.

Nếu nội dung vĩnh viễn độc quyền hoặc nổi bật, hãy đặt endDate thành 20 năm kể từ ngày hiện tại.
releasedEvent.publishedBy Organization (Tổ chức) hoặc Person (Người) Không bắt buộc – Tổ chức hoặc cá nhân đã xuất bản thực thể này.
description Văn bản Rất nên dùng Tại sao? Bản tóm tắt về mùa giải. Nên ưu tiên bản tóm tắt cốt truyện so với bản tóm tắt dữ kiện. Giới hạn 300 ký tự.
actor [Person hoặc PerformingGroup hoặc PerformanceRole Rất nên dùng Tại sao? Một loạt dàn diễn viên của phần này. Xem hướng dẫn lập mô hình tại đây.
director Person (Người) Rất nên dùng Tại sao? Một nhóm các đạo diễn của chương trình.
producer Organization (Tổ chức) hoặc Person (Người) Rất nên dùng Tại sao? (Các) nhà sản xuất của phần đó.
image ImageObject (Đối tượng hình ảnh) Hình ảnh liên quan đến TV Season. Để biết thêm thông tin chi tiết về các thuộc tính bắt buộc và không bắt buộc phải bao gồm với image, hãy xem bài viết Thuộc tính hình ảnh.
genre Văn bản Danh sách theo thứ tự gồm tất cả thể loại có liên quan. Ví dụ : ["Action", "Fashion", "Environment", "Football"]
keywords Văn bản Từ khoá hoặc thẻ dùng để mô tả nội dung này. Một loạt từ khoá cũng được cho phép. Ví dụ: ["đặc điểm, tiểu sử"] có thể là một mảng từ khoá để mô tả nội dung.
trailer.description Văn bản Nội dung mô tả về đoạn giới thiệu. Xem ví dụ về Đoạn giới thiệu.
trailer.inLanguage Văn bản Ngôn ngữ của đoạn giới thiệu ở định dạng BCP 47.
trailer.url URL URL của một đoạn giới thiệu được lưu trữ công khai và do các hãng sản xuất hoặc nguồn được uỷ quyền tương ứng lưu trữ.
trailer.regionsAllowed Địa điểm Các khu vực cho phép nội dung nghe nhìn này. Nếu bạn không chỉ định, thì thuộc tính này được coi là được cho phép ở mọi nơi. Hãy chỉ định các quốc gia theo định dạng ISO 3166.
identifier PropertyValue Rất nên dùng Tại sao? - Mã nhận dạng bên ngoài hoặc mã nhận dạng khác xác định rõ ràng thực thể này. Bạn được phép sử dụng nhiều giá trị nhận dạng. Xem phần Thuộc tính giá trị nhận dạng để biết thông tin chi tiết.
popularityScore PopularityScoreSpecification Rất nên dùng Tại sao? Điểm số mà Google sử dụng cùng với các tín hiệu khác để xác định nội dung nghe nhìn sẽ phát cho người dùng. Điểm số này thể hiện mức độ phổ biến của nội dung so với những nội dung khác trong danh mục của bạn; do đó, thang điểm cần nhất quán trên các nguồn cấp dữ liệu của bạn, giữa tất cả các thực thể trong danh mục của bạn. Theo mặc định, điểm mức độ phổ biến của một thực thể được đặt là 0.
popularityScore.@type Văn bản Luôn đặt thành PopularityScoreSpecification.
popularityScore.value Number Một giá trị số không âm cho biết mức độ phổ biến của thực thể; điểm số càng cao thì mức độ phổ biến càng cao.
popularityScore.eligibleRegion Quốc gia (Các) khu vực có áp dụng điểm số phổ biến này. Nếu điểm phổ biến có thể áp dụng trên toàn cầu, hãy đặt thành EARTH. Theo mặc định, thuộc tính này được đặt thành EARTH.
Note: Mức độ phổ biến theo ngôn ngữ được ưu tiên hơn mức độ phổ biến trên toàn cầu (earth)
review Bài đánh giá Xem lại mức phân loại của phần chương trình truyền hình
review.reviewRating Điểm xếp hạng Bắt buộc nếu bạn cung cấp review Thuộc tính này dùng để xác định điểm xếp hạng trong bài đánh giá.
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, nếu không nên dùng – Mức phân loại nội dung tổng thể. 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ụ: "TV-MA" mức phân loại của công ty quảng cáo "TVPG" ở Hoa Kỳ phải được mô tả là "TVPG TV-MA". 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 điểm xếp hạng của nội dung đó.
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. Xem trang Cơ quan phân loại nội dung để biết danh sách các cơ quan phân loại được chấp nhận
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.

Thông số kỹ thuật về diễn viên

Thuộc tính actor trong các loại thực thể TVSeries, TVEpisodeTVSeason cho phép bạn nêu rõ thông tin chi tiết hơn về các diễn viên, bao gồm cả tên nhân vật và vai trò mà họ đóng trong chương trình truyền hình. (Các) phần sau đây cũng tương tự, cùng với một vài ví dụ làm rõ cách sử dụng.

Thuộc tính Loại dự kiến Mô tả
actor Person hoặc PerformingGroup hoặc PerformanceRole Rất nên dùng Tại sao? : Một mảng gồm các thành viên.
  • Sử dụng loại PerformanceRole khi đã biết vai trò và (không bắt buộc) tên nhân vật của(các) thành viên diễn viên. Người thực hiện Person hoặc PerformingGroup được nhúng bên trong đối tượng PerformanceRole trong trường hợp này.
  • Hãy dùng loại Person(Người) để chỉ ra(các) diễn viên riêng biệt hoặc PerformingGroup dùng để cung cấp thông tin chi tiết về(các) nhóm/nhóm nhạc biểu diễn khi(các) vai trò của(các) thành viên trong diễn viên không xác định được vai trò của họ.

Sử dụng một mảng để đại diện cho nhiều Người, Nhóm biểu diễn hoặc Vai trò thực hiện.

Sử dụng loại Person hoặc PerformingGroup

Cung cấp các thuộc tính sau khi sử dụng loại Person hoặc PerformingGroup

Thuộc tính Loại dự kiến Mô tả
@type Person hoặc PerformingGroup Bắt buộc – Luôn đặt thành Person hoặc performingGroup
@id URL Rất nên dùng Tại sao? – Giá trị nhận dạng diễn viên hoặc nhóm biểu diễn ở định dạng URI; ví dụ: https://example.com/actor/abc. @id phải đáp ứng các yêu cầu sau:
  • Duy nhất trên toàn cầu trong danh mục của bạn theo diễn viên/nhóm biểu diễn
  • Giá trị nhận dạng này phải cố định và không thay đổi theo thời gian. 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)
  • Tổ chức của bạn phải sở hữu miền được dùng cho giá trị @id.

Xin lưu ý rằng @id dùng trong thuộc tính người thực hiện phải được dùng một cách nhất quán trong toàn bộ nguồn cấp dữ liệu. Ví dụ: Nếu có hai Phim có cùng một diễn viên, thì giá trị @id phải được giữ nguyên trên hai đối tượng diễn viên đó.

name Văn bản Bắt buộc – Tên của diễn viên/diễn viên/thành viên diễn viên/nhóm biểu diễn.
sameAs URL Rất nên dùng Tại sao? - URL tới trang web tham khảo có thể nhận dạng người thực hiện hoặc nhóm biểu diễn; ví dụ: trang Wikipedia về diễn viên đó. Thuộc tính này phải khác với thuộc tính @id.

Sử dụng loại PerformanceRole

Cung cấp các thuộc tính sau khi sử dụng loại PerformanceRole

Thuộc tính Loại dự kiến Mô tả
@type PerformanceRole Bắt buộc – Luôn đặt thành PerformanceRole
roleName Văn bản Rất nên dùng Tại sao? – Một vai trò của thành viên trong nhóm diễn, hoặc lồng tiếng. Vui lòng xem danh sách các giá trị được chấp nhận tại đây.
characterName Văn bản Tên của một nhân vật trong vai trò diễn xuất hoặc biểu diễn. Không đặt trường này nếu loại người thực hiện là PerformingGroup.
actor Person hoặc PerformingGroup Bắt buộc -
  • (Các) thành viên truyền của nội dung khi loại dữ liệu Person được sử dụng.
  • (Các) nhóm/băng tần biểu diễn của nội dung khi sử dụng loại dữ liệu PerformingGroup.
actor.@type Person hoặc PerformingGroup Bắt buộc – Luôn đặt thành Person hoặc performingGroup
actor.@id URL Rất nên dùng Tại sao? – Giá trị nhận dạng người thực hiện hoặc nhóm biểu diễn ở định dạng URI; ví dụ: https://example.com/actor/abc. @id phải đáp ứng các yêu cầu sau:
  • Duy nhất trên toàn cầu trong danh mục của bạn theo diễn viên/nhóm biểu diễn
  • Giá trị nhận dạng này phải cố định và không thay đổi theo thời gian. 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)
  • Tổ chức của bạn phải sở hữu miền được dùng cho giá trị @id.

Xin lưu ý rằng @id dùng trong thuộc tính người thực hiện phải được dùng một cách nhất quán trong toàn bộ nguồn cấp dữ liệu. Ví dụ: Nếu có hai Phim có cùng một diễn viên, thì giá trị @id phải được giữ nguyên trên hai đối tượng diễn viên đó.

actor.name Văn bản Bắt buộc – Tên của diễn viên/diễn viên/thành viên diễn viên/nhóm biểu diễn.
actor.sameAs URL Rất nên dùng Tại sao? - URL tới trang web tham khảo có thể nhận dạng người thực hiện hoặc nhóm biểu diễn; ví dụ: trang Wikipedia về diễn viên đó. Thuộc tính này phải khác với thuộc tính actor.@id.

Tên vai trò có thể chấp nhận

Các giá trị này yêu cầu actor.@type phải là Person.

Giá trị roleName Mô tả
"Cameo" Vai trò khách mời (còn gọi là khách mời) là sự xuất hiện ngắn gọn của một người nổi tiếng trong một tác phẩm nghệ thuật biểu diễn.
"Diễn viên lồng tiếng" Biểu diễn giọng nói là khi giọng của diễn viên được sử dụng nhưng diễn viên không xuất hiện trên màn hình. Tình trạng này thường xảy ra nhất trong phim hoạt hình nhưng cũng xảy ra khi giọng của một diễn viên được lồng vào lời nói của một diễn viên khác.
"Gấp đôi" Hai là người thay thế cho một diễn viên khác để khuôn mặt của người đó không xuất hiện.
"MotionCaptureActor" MotionCaptureActor là một người ghi lại hành động của diễn viên người và sử dụng thông tin đó để tạo hoạt ảnh cho các mô hình nhân vật kỹ thuật số trong hoạt ảnh máy tính 2D hoặc 3D.

Các giá trị này thường được chấp nhận cho các loại PersonPerformingGroup.

Giá trị roleName Mô tả
"Diễn viên" Diễn viên nữ là người đóng vai nhân vật trong buổi biểu diễn trong phương tiện truyền thống của nhà hát hoặc trong các phương tiện truyền thông hiện đại như phim ảnh, phát thanh và truyền hình.
"GuestStar" "Ngôi sao khách mời là một diễn viên đóng một vai trò hư cấu và xuất hiện trong một hoặc một vài tập phim. Trong một số trường hợp, một ngôi sao khách mời có thể đóng vai một nhân vật quan trọng lặp lại và có thể xuất hiện nhiều lần trong một chương trình dài tập, mặc dù không phải là thành viên của dàn diễn viên chính. Đặt giá trị thành "GuestStar" khi dàn diễn viên có phần trình diễn của khách mời hoặc khách mời trong chương trình. Bạn chỉ nên cung cấp ngôi sao khách mời ở cấp tập và không nên thêm ngôi sao này ở cấp TV Series.
"Khách" "Một khách mời trong một chương trình trò chuyện. Lưu ý rằng mặc dù "GuestStar" là một vai trò hư cấu, "Khách mời" không phải là hình ảnh hư cấu.
"Phát thanh viên" Bình luận viên là người đưa tin mở màn và bế mạc chương trình, giới thiệu người dẫn chương trình, thí sinh và/hoặc khách mời là người nổi tiếng, mô tả các giải thưởng có sẵn và chuẩn bị cho khán giả trước khi ghi hình và giúp họ giải trí trong thời gian nghỉ giải lao.
"Bình luận viên" Bình luận viên đưa ra bình luận theo thời gian thực về một trận đấu hoặc sự kiện, thường là trong chương trình phát sóng trực tiếp.
"Trường phái ấn tượng" Nghệ sĩ theo trường phái ấn tượng hoặc người bắt chước là người biểu diễn có hành động bắt chước âm thanh, giọng nói và phong thái của người nổi tiếng và nhân vật hoạt hình.
"Máy chủ lưu trữ" Người giới thiệu, trình bày hoặc dẫn chương trình truyền hình, thường đóng vai trò là trung gian hoà giải cho chương trình và khán giả. "Người tổ chức" thường là một vai trò phi hư cấu.
"Người đồng tổ chức" Một người tổ chức sự kiện/chương trình cùng với(các) người khác.
"GuestHost" Người dẫn chương trình khách mời là người dẫn chương trình, thường là của một chương trình trò chuyện, và sẽ dẫn chương trình thay cho người dẫn chương trình thông thường khi không có mặt.
"Phát thanh viên" Người trình bày/thông báo cho công chúng về tin tức và sự kiện đang diễn ra ở quy mô địa phương, quốc gia và quốc tế thông qua một chương trình tin tức truyền hình.
"Người tương ứng" Phóng viên hoặc phóng viên tại hiện trường thường là nhà báo hoặc nhà bình luận cho một tạp chí, hoặc là người đại diện đóng góp bản tin cho một tờ báo, bản tin phát thanh hoặc truyền hình hoặc một loại công ty khác ở một địa điểm xa xôi.
"Trình giám khảo" Giám khảo là một người thường được coi là chuyên gia trong lĩnh vực chương trình và được giao vai trò "giám khảo" để phê bình thí sinh dự thi và tham gia cuộc thi trong loạt phim truyền hình.
"Người tham gia" Thành viên của ban thảo luận hoặc ban cố vấn của một ban phát thanh hoặc truyền hình.
"Thí sinh" Thí sinh trong cuộc thi hoặc chương trình trò chơi là một người tham gia.
"Người dẫn chuyện" Người dẫn chuyện là người tường thuật điều gì đó, đặc biệt là nhân vật kể lại các sự kiện trong một cuốn tiểu thuyết hoặc một bài thơ tường thuật
"MusicalArtist" (Nghệ sĩ âm nhạc) "Nghệ sĩ âm nhạc có thể là một người, một nhóm nhạc hoặc một nhân vật hư cấu thường xuyên biểu diễn trước mặt khán giả hoặc đã thu âm các bản nhạc hay đĩa nhạc. Nhà soạn nhạc và người viết lời chỉ nên có loại này nếu thông tin ghi công của một số tác phẩm âm nhạc ngụ ý rằng họ cũng đóng góp với tư cách là nghệ sĩ biểu diễn chính. Loại tài khoản này có thể dùng để liên kết các Nhạc sĩ hoặc Nhóm nhạc sĩ thường xuyên, và Liên kết Nhạc sĩ hoặc Nhóm nhạc sĩ khách mời để tham gia các chương trình.

Phân biệt giữa vai chính và vai phụ của diễn viên

Để phân biệt giữa diễn viên chính/bình thường và diễn viên khách/hỗ trợ trong chương trình truyền hình, hãy chỉ thêm dàn diễn viên chính trên thực thể TVSeries và chỉ thêm dàn diễn viên khách mời hoặc diễn viên có vai trò phụ trên thực thể TVEpisode. Đảm bảo hệ thống truyền chính/thông thường không được thêm vào các thực thể TVEpisode.

Ví dụ

Ví dụ về TVSeries, TVEpisodeTVSeason

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Ví dụ về thuộc tính Actor

Không xác định được vai trò của diễn viên

Khi không xác định được vai trò của diễn viên, bạn chỉ nên cung cấp thông tin về diễn viên bằng cách sử dụng type Person hoặc PerformingGroup

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

Người xem biết rõ vai trò của diễn viên

Khi đã biết vai trò của một diễn viên, bạn nên cung cấp thông tin về diễn viên đó bằng cách sử dụng loại PerformanceRole

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

Vai trò đã biết của một nhóm nhỏ diễn viên

Khi không xác định được siêu dữ liệu về vai trò thực hiện, bạn nên cung cấp thông tin về diễn viên bằng cách sử dụng loại Person hoặc PerformingGroup . Đối với trường hợp còn lại, khi biết thông tin này, hãy sử dụng loại PerformanceRole . Bạn có thể thêm các loại này cùng nhau trong cùng một mảng.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

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