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, TVEpisode và TVSeason.

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ệ giữa TVSeries, 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"}] Trong đó"xx" thể hiện ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Bạn nên đặt @language cho ngữ cảnh thực thể gốc thành mã ngôn ngữ thích hợp ở định dạng định dạng BCP 47. Ví dụ: nếu ngôn ngữ được đặt thành tiếng Tây Ban Nha, các tên này được giả định là tiếng Tây Ban Nha ngay cả khi 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: Toàn cầu là duy nhất trên danh mục của bạn Mã này phải ổn đị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 liên kết hoạt động. Dưới dạng Số nhận dạng tài nguyên hợp nhất (URI) Miền dùng cho giá trị @id phải do tổ chức của bạn sở hữu. Vì url của một thực thể đáp ứng mọi yêu cầu dưới dạng giá trị nhận dạng, nên bạn cần sử dụng url của một thực thể làm @id. Hãy xem mục Giá trị nhận dạng để biết thêm thông tin chi tiết.
url	URL	Bắt buộc – URL 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 bản phát lại, 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 chương trình. Sử dụng một mảng để liệt kê tên ở các ngôn ngữ khác nhau. Xem ví dụ Nhiều khu vực và ngôn ngữ. Lưu ý rằng chỉ có một tên được hỗ trợ 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? - Số nhận dạng EIDR (Registry Identifier Registry) đại diện cho cấp độ khái quát/chung nhất của một tác phẩm điện ảnh hoặc truyền hình. Ví dụ: tựa đề EIDR cho TVSeries có tên là "Game of Thrones" 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ó trong Video theo yêu cầu (VoD), thuộc tính này là bắt buộc; đối tượng đánh dấu Hành động cần cung cấp liên kết sâu của nội dung. Nếu nội dung có trên kênh LiveTV thì thuộc tính này là tùy chọn; thực thể BroadcastService được liên kết sẽ cung cấp liên kết sâu của kênh. TVSeries có 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ụ 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 biệt 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ự tất cả thể loại liên quan. Ví dụ : ["Action", "Fashion", "Environment", "Football"]
keywords	Văn bản	Từ khóa hoặc thẻ được sử dụng để mô tả nội dung này. Hệ thống cũng cho phép một mảng từ khóa. Ví dụ: ["tính năng, tiểu sử"] có thể là một mảng từ khóa để 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 nội dung gốc (toàn cầu hoặc địa phương) của nhà xuất bản, chẳng hạn như ngày phát hành tại rạp ban đầu. Ngoài ra, hãy dùng FeaturedEvent để cho biết dịch vụ của bạn tiếp thị nội dung này dưới dạng một tác phẩm gốc, nổi bật, đặc biệt, v.v. ExclusiveEvent cho biết rằng dịch vụ của bạn có quyền phân phối độc quyền và bao gồm thông tin chi tiết về địa điểm và thời gian.
releasedEvent.@type	Văn bản	Bắt buộc – Hãy nhớ luôn đặt thuộc tính này thành một trong các tùy chọn sau: PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	Quốc gia	Bắt buộc – Các khu vực liên quan đến sự kiện này. Đối với PublicationEvent, đây là khu vực nơi nội dung được xuất bản. Đối với FeaturedEvent và ExclusiveEvent, đây là khu vực có nội dung nổi bật hoặc độc quyền. Hãy sử dụng mã ISO 3166 cho các quốc gia. Để chỉ báo ở mọi nơi trên thế giới, hãy đặt thành EARTH.
releasedEvent.startDate	Ngày hoặc Ngày giờ	Được đề xuất - Bắt buộc đối với ExclusiveEvent - Ngày bắt đầu xuất bản của thực thể. Đối với PublicationEvent, đây là ngày phát hành ban đầu của thực thể này, chẳng hạn như ngày phát hành bộ phim lần đầu tiên. Đối với ExclusiveEvent và FeaturedEvent, đây là ngày bắt đầu khi thực thể độc quyền hoặc được giới thiệu.
releasedEvent.endDate	Ngày hoặc Ngày giờ	Nên dùng – Bắt buộc đối với ExclusiveEvent – Chỉ áp dụng cho loại ExclusiveEvent và FeaturedEvent. Đối với ExclusiveEvent, đây là ngày mà các quyền đối với nội dung hết hạn. Đối với FeaturedEvent, đây là ngày gần nhất mà nhà cung cấp giới thiệu về thực thể. Nếu nội dung đó thuộc về độc quyền hoặc nội dung vĩnh viễn, 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)	Tùy chọn - Tổ chức hoặc người đã xuất bản đối tượng 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. Bản tóm tắt cốt truyện được ưu tiên so với các bản tóm tắt thực tế. Giới hạn 300 ký tự. Sử dụng một mảng để đánh dấu phần mô tả bằng nhiều ngôn ngữ. Xem ví dụ Nhiều khu vực và ngôn ngữ.
actor	Person (Người biểu diễn) hoặc PerformingGroup (Nhóm biểu diễn) hoặc PerformanceRole (Vai trò)	Rất nên dùng Tại sao? Một mảng gồm các thành viên tham gia diễn xuất của bộ 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? (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 chương trình.
image	ImageObject	Bắt buộc đối với Google TV – Hình ảnh liên quan đến TVSeries. Để 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 cần đưa vào trong image, hãy xem phần Thuộc tính hình ảnh.
trailer.description	Văn bản	Mô tả đ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 đoạn giới thiệu được lưu trữ công khai và do các studio sản xuất tương ứng tải lên hoặc được ủy quyền.
trailer.regionsAllowed	Địa điểm	Vùng được phép sử dụng nội dung nghe nhìn. Nếu bạn không chỉ định thì mã này sẽ được cho phép ở mọi nơi. Chỉ định quốc gia ở định dạng ISO 3166.
identifier	PropertyValue	Rất nên dùng Tại sao? - ID bên ngoài hoặc ID khác xác định rõ ràng thực thể này. Cho phép có nhiều số nhận dạng. Xem mục Thuộc tính số nhận dạng để biết chi tiết.
popularityScore	Thông số điểm phổ biến	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ên phát nội dung nghe nhìn nào 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 nội dung khác trong danh mục của bạn; do đó, thang điểm của các điểm trên danh sách của bạn phải nhất quá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 phổ biến của một thực thể được đặt thành 0.
popularityScore.@type	Văn bản	Luôn đặt thành PopularityScoreSpecification.
popularityScore.value	Number	Giá trị số không âm cho biết mức độ phổ biến của đối tượng; điểm cao hơn có nghĩa là mức độ phổ biến cao hơn.
popularityScore.eligibleRegion	Quốc gia	(Các) vùng có điểm phổ biến này. Nếu điểm phổ biến á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 từng ngôn ngữ được ưu tiên hơn mức độ phổ biến toàn cầu (EARTH)
review	Bài đánh giá	Đánh giá xếp hạng cho loạt phim truyền hình
review.reviewRating	Điểm xếp hạng	Bắt buộc nếu có cung cấp review Thông tin này dùng để chỉ định điểm xếp hạng có trong bài đánh giá.
contentRating	Text (Văn bản) hoặc Rating (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 theo cách khác - Xếp hạng nội dung tổng thể. Nếu xếp hạng nội dung được cung cấp dưới dạng chuỗi văn bản, hai biến thể được chấp nhận: Cơ quan xếp hạng thêm trước điểm xếp hạng với khoảng trắng ở giữa. Ví dụ: Xếp hạng "TV-MA" từ đại lý "TVPG" ở Hoa Kỳ phải được mô tả là "TVPG TV-MA". Xem danh sách đại lý. Giá trị "RATING NOT KNOWN" (không phân biệt chữ hoa chữ thường) để cho biết rằng bạn không biết thứ hạng của nội dung đó.
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. Xem trang Cơ quan xếp hạng nội dung để biết danh sách các cơ quan xếp hạng đượ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 khiêu dâm, 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"}] Trong đó"xx" thể hiện ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Bạn nên đặt @language cho ngữ cảnh thực thể gốc thành mã ngôn ngữ thích hợp ở định dạng định dạng BCP 47. Ví dụ: nếu ngôn ngữ được đặt thành tiếng Tây Ban Nha, các tên này được giả định là tiếng Tây Ban Nha ngay cả khi 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: Toàn cầu là duy nhất trên danh mục của bạn Mã này phải ổn đị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 liên kết hoạt động. Dưới dạng Số nhận dạng tài nguyên hợp nhất (URI) Miền dùng cho giá trị @id phải do tổ chức của bạn sở hữu. Vì url của một thực thể đáp ứng mọi yêu cầu dưới dạng giá trị nhận dạng, nên bạn cần sử dụng url của một thực thể làm @id. Hãy xem mục Giá trị nhận dạng để biết thêm thông tin chi tiết.
url	URL	Bắt buộc – URL 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 bản phát lại, 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 tập. Sử dụng một mảng để liệt kê tên ở các ngôn ngữ khác nhau. Xem ví dụ Trình bày nhiều ngôn ngữ. Lưu ý rằng chỉ có một tên được hỗ trợ 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? - Số nhận dạng EIDR (Registry Identifier Registry) đại diện cho cấp độ khái quát/chung nhất của một tác phẩm điện ảnh hoặc truyền hình. Ví dụ: Tiêu đề cho tập đầu tiên của phần đầu tiên trong chương trình truyền hình dài tập có tên là "Game of Thrones" là "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
editEIDR	Văn bản	Rất nên dùng Tại sao? - Số nhận dạng EIDR (Đăng ký nhận dạng giải trí) thể hiện bản chỉnh sửa / ấn bản cụ thể của một 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 trong TVSeries có tên là "Game of Thrones" có tiêu đề "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-". titleEIDRThuộc tính là 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ố biểu thị vị trí của tập này theo thứ tự của các tập trong một phần. episodeNumber cần khởi động lại mỗi 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 thuộc 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.@id và partOfSeason.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 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ố chỉ cho biết vị trí của phần này theo thứ tự các phần trong phim truyền hình.
partOfSeries	TVSeries	Bắt buộc - Chương trình truyền hình dài tập.
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 biệt 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ó trong Video theo yêu cầu (VoD), thuộc tính này là bắt buộc; đối tượng đánh dấu Hành động cần cung cấp liên kết sâu của nội dung. Nếu nội dung có trên kênh LiveTV thì thuộc tính này là tùy chọn; thực thể BroadcastService được liên kết sẽ cung cấp liên kết sâu của kênh. TVEpisode có 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ụ Nhiều khu vực và ngôn ngữ.
sameAs	Rất nên dùng Tại sao? URL (Mục hướng dẫn)	URL đến một trang web tham khảo có thể xác định được tập; đối với bài kiểm tra, trang Wikipedia của tập. Thuộc tính này phải khác biệt với thuộc tính url.
duration	Thời lượng	Thời gian chạy 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 nội dung gốc (toàn cầu hoặc địa phương) của nhà xuất bản, chẳng hạn như ngày phát hành tại rạp ban đầu. Ngoài ra, hãy dùng FeaturedEvent để cho biết dịch vụ của bạn tiếp thị nội dung này dưới dạng một tác phẩm gốc, nổi bật, đặc biệt, v.v. ExclusiveEvent cho biết rằng dịch vụ của bạn có quyền phân phối độc quyền và bao gồm thông tin chi tiết về địa điểm và thời gian.
releasedEvent.@type	Văn bản	Bắt buộc – Hãy nhớ luôn đặt thuộc tính này thành một trong các tùy chọn sau: PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	Quốc gia	Bắt buộc – Các khu vực liên quan đến sự kiện này. Đối với PublicationEvent, đây là khu vực nơi nội dung được xuất bản. Đối với FeaturedEvent và ExclusiveEvent, đây là khu vực có nội dung nổi bật hoặc độc quyền. Hãy sử dụng mã ISO 3166 cho các quốc gia. Để chỉ báo ở mọi nơi trên thế giới, hãy đặt thành EARTH.
releasedEvent.startDate	Ngày hoặc Ngày giờ	Được đề xuất - Bắt buộc đối với ExclusiveEvent - Ngày bắt đầu xuất bản của thực thể. Đối với PublicationEvent, đây là ngày phát hành ban đầu của thực thể này, chẳng hạn như ngày phát hành bộ phim lần đầu tiên. Đối với ExclusiveEvent và FeaturedEvent, đây là ngày bắt đầu khi thực thể độc quyền hoặc được giới thiệu.
releasedEvent.endDate	Ngày hoặc Ngày giờ	Nên dùng – Bắt buộc đối với ExclusiveEvent – Chỉ áp dụng cho loại ExclusiveEvent và FeaturedEvent. Đối với ExclusiveEvent, đây là ngày mà các quyền đối với nội dung hết hạn. Đối với FeaturedEvent, đây là ngày gần nhất mà nhà cung cấp giới thiệu về thực thể. Nếu nội dung đó thuộc về độc quyền hoặc nội dung vĩnh viễn, 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)	Tùy chọn - Tổ chức hoặc người đã xuất bản đối tượng này.
description	Văn bản	Rất nên dùng Tại sao? Bản tóm tắt tập. Bản tóm tắt cốt truyện được ưu tiên so với các bản tóm tắt thực tế. Giới hạn 300 ký tự. Sử dụng một mảng để đánh dấu phần mô tả bằng nhiều ngôn ngữ. Xem ví dụ Trình bày nhiều ngôn ngữ.
genre	Văn bản	Danh sách theo thứ tự tất cả thể loại liên quan. Ví dụ : ["Action", "Fashion", "Environment", "Football"]
keywords	Văn bản	Từ khóa hoặc thẻ được sử dụng để mô tả nội dung này. Hệ thống cũng cho phép một mảng từ khóa. Ví dụ: ["tính năng, tiểu sử"] có thể là một mảng từ khóa để mô tả nội dung.
actor	Person (Người biểu diễn) hoặc PerformingGroup (Nhóm biểu diễn) hoặc PerformanceRole (Vai trò)	Rất nên dùng Tại sao? Một mảng gồm các thành viên tham gia tập. 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? (Các) Đạ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	Rất nên dùng Tại sao? cho Google TV - Nhiều hình ảnh khác nhau 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 cần đưa vào trong image, hãy xem phần Thuộc tính hình ảnh.
trailer.description	Văn bản	Mô tả đ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 đoạn giới thiệu được lưu trữ công khai và do các studio sản xuất tương ứng tải lên hoặc được ủy quyền.
trailer.regionsAllowed	Địa điểm	Vùng được phép sử dụng nội dung nghe nhìn. Nếu bạn không chỉ định thì mã này sẽ được cho phép ở mọi nơi. Chỉ định quốc gia ở định dạng ISO 3166.
review	Bài đánh giá	Xem xếp hạng của tập phim truyền hình
review.reviewRating	Điểm xếp hạng	Bắt buộc nếu có cung cấp review Thông tin này dùng để chỉ định điểm xếp hạng có trong bài đánh giá.
contentRating	Text (Văn bản) hoặc Rating (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 theo cách khác - Xếp hạng nội dung tổng thể. Nếu xếp hạng nội dung được cung cấp dưới dạng chuỗi văn bản, hai biến thể được chấp nhận: Cơ quan xếp hạng thêm trước điểm xếp hạng với khoảng trắng ở giữa. Ví dụ: Xếp hạng "TV-MA" từ đại lý "TVPG" ở Hoa Kỳ phải được mô tả là "TVPG TV-MA". Xem danh sách đại lý. Giá trị "RATING NOT KNOWN" (không phân biệt chữ hoa chữ thường) để cho biết rằng bạn không biết thứ hạng của nội dung đó.
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. Xem trang Cơ quan xếp hạng nội dung để biết danh sách các cơ quan xếp hạng đượ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 khiêu dâm, V = Bạo lực.
identifier	PropertyValue	Rất nên dùng Tại sao? - ID bên ngoài hoặc ID khác xác định rõ ràng thực thể này. Cho phép có nhiều số nhận dạng. Xem mục Thuộc tính số nhận dạng để biết chi tiết.
popularityScore	Thông số điểm phổ biến	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ên phát nội dung nghe nhìn nào 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 nội dung khác trong danh mục của bạn; do đó, thang điểm của các điểm trên danh sách của bạn phải nhất quá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 phổ biến của một thực thể được đặt thành 0.
popularityScore.@type	Văn bản	Luôn đặt thành PopularityScoreSpecification.
popularityScore.value	Number	Giá trị số không âm cho biết mức độ phổ biến của đối tượng; điểm cao hơn có nghĩa là mức độ phổ biến cao hơn.
popularityScore.eligibleRegion	Quốc gia	(Các) vùng có điểm phổ biến này. Nếu điểm phổ biến á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 từng ngôn ngữ được ưu tiên hơn mức độ phổ biế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"}] Trong đó"xx" thể hiện ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Bạn nên đặt @language cho ngữ cảnh thực thể gốc thành mã ngôn ngữ thích hợp ở định dạng định dạng BCP 47. Ví dụ: nếu ngôn ngữ được đặt thành tiếng Tây Ban Nha, các tên này được giả định là tiếng Tây Ban Nha ngay cả khi 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: Toàn cầu là duy nhất trên danh mục của bạn Mã này phải ổn đị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 liên kết hoạt động. Dưới dạng Số nhận dạng tài nguyên hợp nhất (URI) Miền dùng cho giá trị @id phải do tổ chức của bạn sở hữu. Vì url của một thực thể đáp ứng mọi yêu cầu dưới dạng giá trị nhận dạng, nên bạn cần sử dụng url của một thực thể làm @id. Hãy xem mục Giá trị nhận dạng để biết thêm thông tin chi tiết.
url	URL	Bắt buộc – URL 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 bản phát lại, 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 ở các ngôn ngữ khác nhau. Xem ví dụ Trình bày nhiều ngôn ngữ. Lưu ý rằng chỉ có một tên được hỗ trợ 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? - Số nhận dạng EIDR (Registry Identifier Registry) đại diện cho cấp độ khái quát/chung nhất của một tác phẩm điện ảnh hoặc truyền hình. Ví dụ: tựa đề cho mùa đầu tiên của TVSeries có tên là "Game of Thrones" là "10.5240/FD91-C72C-4161-FCBA-058B-1".
seasonNumber	Số nguyên	Bắt buộc – Số chỉ cho biết vị trí của phần này theo thứ tự các phần trong phim truyền hình.
partOfSeries	TVSeries	Bắt buộc - Chương trình 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 trong mùa 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 biệt 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ó trong Video theo yêu cầu (VoD), thuộc tính này là bắt buộc; đối tượng đánh dấu Hành động cần cung cấp liên kết sâu của nội dung. Nếu nội dung có trên kênh LiveTV thì thuộc tính này là tùy chọn; thực thể BroadcastService được liên kết sẽ cung cấp liên kết sâu của kênh. TVSeason có 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ụ 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ể nhận dạng phần; ví dụ: trang Wikipedia của phần. Thuộc tính này phải khác biệt 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 nội dung gốc (toàn cầu hoặc địa phương) của nhà xuất bản, chẳng hạn như ngày phát hành tại rạp ban đầu. Ngoài ra, hãy dùng FeaturedEvent để cho biết dịch vụ của bạn tiếp thị nội dung này dưới dạng một tác phẩm gốc, nổi bật, đặc biệt, v.v. ExclusiveEvent cho biết rằng dịch vụ của bạn có quyền phân phối độc quyền và bao gồm thông tin chi tiết về địa điểm và thời gian.
releasedEvent.@type	Văn bản	Bắt buộc – Hãy nhớ luôn đặt thuộc tính này thành một trong các tùy chọn sau: PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	Quốc gia	Bắt buộc – Các khu vực liên quan đến sự kiện này. Đối với PublicationEvent, đây là khu vực nơi nội dung được xuất bản. Đối với FeaturedEvent và ExclusiveEvent, đây là khu vực có nội dung nổi bật hoặc độc quyền. Hãy sử dụng mã ISO 3166 cho các quốc gia. Để chỉ báo ở mọi nơi trên thế giới, hãy đặt thành EARTH.
releasedEvent.startDate	Ngày hoặc Ngày giờ	Được đề xuất - Bắt buộc đối với ExclusiveEvent - Ngày bắt đầu xuất bản của thực thể. Đối với PublicationEvent, đây là ngày phát hành ban đầu của thực thể này, chẳng hạn như ngày phát hành bộ phim lần đầu tiên. Đối với ExclusiveEvent và FeaturedEvent, đây là ngày bắt đầu khi thực thể độc quyền hoặc được giới thiệu.
releasedEvent.endDate	Ngày hoặc Ngày giờ	Nên dùng – Bắt buộc đối với ExclusiveEvent – Chỉ áp dụng cho loại ExclusiveEvent và FeaturedEvent. Đối với ExclusiveEvent, đây là ngày mà các quyền đối với nội dung hết hạn. Đối với FeaturedEvent, đây là ngày gần nhất mà nhà cung cấp giới thiệu về thực thể. Nếu nội dung đó thuộc về độc quyền hoặc nội dung vĩnh viễn, 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)	Tùy chọn - Tổ chức hoặc người đã xuất bản đối tượng này.
description	Văn bản	Rất nên dùng Tại sao? Bản tóm tắt về phần này. Bản tóm tắt cốt truyện được ưu tiên so với các bản tóm tắt thực tế. Giới hạn 300 ký tự. Sử dụng một mảng để đánh dấu phần mô tả bằng nhiều ngôn ngữ. Xem ví dụ Trình bày nhiều ngôn ngữ.
actor	[Person, PerformingGroup hoặc PerformanceRole	Rất nên dùng Tại sao? Một mảng dàn diễn viên của phần. 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 mảng 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	Hình ảnh liên quan đến TVSeason. Để 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 cần đưa vào trong image, hãy xem phần Thuộc tính hình ảnh.
genre	Văn bản	Danh sách theo thứ tự tất cả thể loại liên quan. Ví dụ : ["Action", "Fashion", "Environment", "Football"]
keywords	Văn bản	Từ khóa hoặc thẻ được sử dụng để mô tả nội dung này. Hệ thống cũng cho phép một mảng từ khóa. Ví dụ: ["tính năng, tiểu sử"] có thể là một mảng từ khóa để mô tả nội dung.
trailer.description	Văn bản	Mô tả đ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 đoạn giới thiệu được lưu trữ công khai và do các studio sản xuất tương ứng tải lên hoặc được ủy quyền.
trailer.regionsAllowed	Địa điểm	Vùng được phép sử dụng nội dung nghe nhìn. Nếu bạn không chỉ định thì mã này sẽ được cho phép ở mọi nơi. Chỉ định quốc gia ở định dạng ISO 3166.
identifier	PropertyValue	Rất nên dùng Tại sao? - ID bên ngoài hoặc ID khác xác định rõ ràng thực thể này. Cho phép có nhiều số nhận dạng. Xem mục Thuộc tính số nhận dạng để biết chi tiết.
popularityScore	Thông số điểm phổ biến	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ên phát nội dung nghe nhìn nào 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 nội dung khác trong danh mục của bạn; do đó, thang điểm của các điểm trên danh sách của bạn phải nhất quá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 phổ biến của một thực thể được đặt thành 0.
popularityScore.@type	Văn bản	Luôn đặt thành PopularityScoreSpecification.
popularityScore.value	Number	Giá trị số không âm cho biết mức độ phổ biến của đối tượng; điểm cao hơn có nghĩa là mức độ phổ biến cao hơn.
popularityScore.eligibleRegion	Quốc gia	(Các) vùng có điểm phổ biến này. Nếu điểm phổ biến á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 từng ngôn ngữ được ưu tiên hơn mức độ phổ biến toàn cầu (EARTH)
review	Bài đánh giá	Xem lại xếp hạng cho phần chương trình truyền hình
review.reviewRating	Điểm xếp hạng	Bắt buộc nếu có cung cấp review Thông tin này dùng để chỉ định điểm xếp hạng có trong bài đánh giá.
contentRating	Text (Văn bản) hoặc Rating (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 theo cách khác - Xếp hạng nội dung tổng thể. Nếu xếp hạng nội dung được cung cấp dưới dạng chuỗi văn bản, hai biến thể được chấp nhận: Cơ quan xếp hạng thêm trước điểm xếp hạng với khoảng trắng ở giữa. Ví dụ: Xếp hạng "TV-MA" từ đại lý "TVPG" ở Hoa Kỳ phải được mô tả là "TVPG TV-MA". Xem danh sách đại lý. Giá trị "RATING NOT KNOWN" (không phân biệt chữ hoa chữ thường) để cho biết rằng bạn không biết thứ hạng của nội dung đó.
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. Xem trang Cơ quan xếp hạng nội dung để biết danh sách các cơ quan xếp hạng đượ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 khiêu dâm, V = Bạo lực.

Thông số kỹ thuật của người thực hiện

Thuộc tính actor trong các loại thực thể TVSeries, TVEpisode và TVSeason cho phép bạn chỉ định thêm thông tin chi tiết về diễn viên, bao gồm cả tên nhân vật của họ và vai trò của họ trong chương trình truyền hình. Phần sau đây trình bày cùng một cách và kèm theo một số ví dụ làm rõ cách sử dụng.

Thuộc tính	Loại dự kiến	Mô tả
actor	Person (Người biểu diễn) hoặc PerformingGroup (Nhóm biểu diễn) hoặc PerformanceRole (Vai trò)	Rất nên dùng Tại sao? : Một mảng gồm các thành viên tham gia diễn xuất. Sử dụng loại PerformanceRole khi có vai trò và xác định tên ký tự của (các) thành viên tham gia diễn xuất. Trong trường hợp này, diễn viên Person hoặc PerformingGroup được nhúng bên trong đối tượng PerformanceRole. Sử dụng loại Person để chỉ ra (các) diễn viên chia sẻ hoặc PerformingGroup để cung cấp thông tin chi tiết về (các) nhóm biểu diễn khi (các) vai trò của (các) thành viên không xác định. Sử dụng một mảng đại diện cho nhiều người, nhóm hoạt động hoặc vai trò hiệu suất.

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 (Người) hoặc PerformingGroup (Nhóm biểu diễn)	Bắt buộc - Luôn đặt thành Person hoặc PerformingGroup
@id	URL	Rất nên dùng Tại sao? - Diễn viên hoặc người thực hiện định danh nhóm ở định dạng URI; ví dụ: https://example.com/actor/abc. @id phải đáp ứng các yêu cầu sau: Toàn cầu là duy nhất trên danh mục của bạn trên mỗi diễn viên/nhóm diễn xuất ID 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 liên kết hoạt động. Dưới dạng Số 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 dùng cho giá trị @id. Lưu ý rằng @id được sử dụng trong thuộc tính của người thực hiện phải được sử dụng 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ữ giống nhau trên hai đối tượng này.
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 tham gia/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 diện diễn viên hoặc nhóm biểu diễn; ví dụ: trang Wikipedia của diễn viên. Thuộc tính này phải khác biệt 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	Vai trò hiệu suất	Bắt buộc – Luôn đặt thành PerformanceRole
roleName	Văn bản	Rất nên dùng Tại sao? – Vai trò do diễn viên đảm nhận, vai diễn hoặc người thực hiện. 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 đóng vai trò diễn hoặc diễn nào đó. Không đặt trường này nếu loại người thực hiện là PerformingGroup.
actor	Person (Người) hoặc PerformingGroup (Nhóm biểu diễn)	Bắt buộc - (Các) thành viên tham gia cho nội dung khi sử dụng loại dữ liệu Person. (Các) nhóm/nhóm hoạt động của nội dung khi sử dụng loại dữ liệu PerformingGroup.
actor.@type	Person (Người) hoặc PerformingGroup (Nhóm biểu diễn)	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? - Diễn viên hoặc người thực hiện định danh nhóm ở định dạng URI; ví dụ: https://example.com/actor/abc. @id phải đáp ứng các yêu cầu sau: Toàn cầu là duy nhất trên danh mục của bạn trên mỗi diễn viên/nhóm diễn xuất ID 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 liên kết hoạt động. Dưới dạng Số 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 dùng cho giá trị @id. Lưu ý rằng @id được sử dụng trong thuộc tính của người thực hiện phải được sử dụng 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ữ giống nhau trên hai đối tượng này.
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 tham gia/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 diện diễn viên hoặc nhóm biểu diễn; ví dụ: trang Wikipedia của diễn viên. Giá trị này phải khác với thuộc tính actor.@id.

Tên vai trò được chấp nhận

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

Giá trị roleName	Mô tả
"Cameo"	Vai 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 tác phẩm nghệ thuật biểu diễn.
"Diễn viên lồng tiếng"	Diễn xuất bằng giọng nói là diễn xuất sử dụng giọng nói của diễn viên nhưng diễn viên không xuất hiện trên màn hình. Điều này thường thấy nhất ở hoạt ảnh nhưng cũng xảy ra khi giọng lồng tiếng của diễn viên lồng tiếng trong bài diễn văn của diễn viên khác.
"Kép"	Nhân đôi là người thay thế diễn viên khác trong đó khuôn mặt của người đó không hiển thị.
"Chuyển động thu hút"	MotionCaptureActor là một người ghi lại hành động của diễn viên 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 2D hoặc 3D trên máy tính.

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

Giá trị roleName	Mô tả
"Diễn viên"	Diễn viên hoặc diễn viên là người miêu tả nhân vật trong buổi biểu diễn trong môi trường truyền thống của nhà hát hoặc trên các phương tiện truyền thông hiện đại như phim, đài và truyền hình.
"Khách mời ngôi sao"	"Diễn viên khách mời là một diễn viên đóng vai hư cấu và xuất hiện trong một hoặc một vài tập. 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 định kỳ quan trọng và xuất hiện nhiều lần trong một loạt phim 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 diễn viên có buổi biểu diễn của khách hoặc khách mời trong chương trình. Bạn chỉ nên cung cấp khách mời ở cấp tập và không nên thêm ở cấp TVSeries.
"Khách"	"Khách mời trong chương trình trò chuyện. Xin lưu ý rằng mặc dù "Khách mời" là vai trò hư cấu, nhưng "Khách mời" không phải là vai trò hư cấu.
"Người phát ngôn"	Phát thanh viên là người phát biểu khai mạc và bế mạc cho 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 nổi tiếng, mô tả các giải thưởng hiện có và khơi dậy sự hào hứng cho khán giả trước khi bấm máy và giúp họ giải trí trong giờ nghỉ.
"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ò chơi hoặc sự kiện, thường là trong một chương trình phát sóng trực tiếp.
"Người theo trường phái ấn tượng"	Người theo trường phái ấn tượng hoặc bắt chước là một nghệ sĩ biểu diễn có hành động bắt chước âm thanh, tiếng nói và phong cách của người nổi tiếng cũng như các nhân vật hoạt hình.
"Máy chủ lưu trữ"	Một người giới thiệu, trình bày hoặc dẫn chương trình truyền hình, thường là người dàn xếp cho chương trình và khán giả. "Người dẫn chương trình" thường là một vai trò phi hư cấu.
"Người dẫn chương trình"	Một người tổ chức một sự kiện/chương trình cùng với(những) người khác.
"Máy chủ khách"	Người dẫn chương trình khách là một người dẫn chương trình, thường là một chương trình trò chuyện, tổ chức chương trình thay cho người dẫn chương trình thường xuyên khi không có sẵn.
"Người tổng hợp tin bài"	Một người trình bày/thông báo cho công chúng về tin tức và sự kiện xảy ra ở phạm vi địa phương, quốc gia và quốc tế thông qua chương trình tin tức trên truyền hình.
"Người trả lời"	Phóng viên hiện trường hoặc phóng viên hiện trường thường là nhà báo hoặc nhà bình luận của một tạp chí hoặc người đại diện đóng góp tin tức cho báo chí, đài phát thanh hoặc truyền hình hoặc một loại công ty khác từ một địa điểm xa xôi, thường ở xa.
"Giám khảo chương trình"	Giám khảo là một người thường được coi là chuyên gia trong lĩnh vực đó và được giao vai trò "người phán xét" để phê bình các thí sinh dự thi và bước vào cuộc thi của bộ phim truyền hình.
"Bảng điều khiển"	Thành viên của ban thảo luận hoặc nhóm cố vấn của ban đài hoặc truyền hình.
"Thánh giáo"	Người dự thi trong cuộc thi hoặc chương trình trò chơi là người tham gia.
"StoryNarrator"	Người tường thuật 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 của một bài thơ hoặc truyện kể
"Nghệ sĩ âm nhạc"	"Nghệ sĩ âm nhạc có thể là một người hoặc một nhóm hoặc một nhân vật hư cấu thường biểu diễn trước khán giả thường xuyên hoặc đã thu âm bản nhạc hoặc album nhạc. Nhà soạn nhạc và người viết lời chỉ nên có loại nhạc này nếu phần 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à người biểu diễn chính. Bạn có thể sử dụng loại này để liên kết Nhạc sĩ hoặc Nhóm Nhạc sĩ cố định với Nhóm Nhạc sĩ hoặc Nhạc sĩ khách mời trong chương trình.

Phân biệt vai chính và vai phụ trong một diễn viên

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

Ví dụ

Ví dụ về TVSeries, TVEpisode và TVSeason

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

Vai trò của người thực hiện không xác định

Khi vai trò của diễn viên không xác định, chúng tôi khuyên bạn chỉ nên cung cấp thông tin diễn viên bằng cách sử dụng Người hoặc PerformingGroup loại

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

Vai trò của diễn viên được biết đến

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

"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 cho tập hợp con của diễn viên

Khi không xác định được siêu dữ liệu vai trò hiệu suất, bạn nên cung cấp thông tin diễn viên bằng cách sử dụng loại Person hoặc PerformingGroup. Đối với trường hợp đã biết thông tin này, hãy sử dụng loại PerformanceRole . Bạn có thể kết hợp các loại này 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"
  }
]

Các trang liên quan

Hãy xem các trang sau để biết các chủ đề liên quan đến các thuộc tính này:

• Xác định loại thực thể cho nội dung của bạn
• Thu thập mã nhận dạng, URL và tên nội dung
• Xác định mối quan hệ giữa các bộ phim truyền hình, phần chương trình truyền hình và tập chương trình truyền hình
• Thu thập siêu dữ liệu về nội dung của bạn