Trang này được dịch bởi Cloud Translation API.

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 đủ. Hã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 TVEpisode 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" biểu thị ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Mỗi ngữ cảnh thực thể gốc phải đặt @language thành mã ngôn ngữ thích hợp ở định dạng BCP 47. Ví dụ: nếu ngôn ngữ được đặt thành tiếng Tây Ban Nha, thì tên sẽ được giả định là 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: Riêng biệt trên toàn bộ 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 đang hoạt động. Dưới 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. Vì `url` của một thực thể đáp ứng tất cả các yêu cầu đối với giá trị nhận dạng, nên bạn nên sử dụng `url` của thực thể làm `@id`. Hãy xem phần Giá trị nhận dạng để biết thêm thông tin chi tiết.
`url`	URL	Bắt buộc – URL chính tắc của nội dung. Google sử dụng URL này để 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. Đối với đườ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 mục tiêu.
`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 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 mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia) chỉ được hỗ trợ một tên.
`titleEIDR`	Văn bản	Rất nên dùng Lý do? – Giá trị nhận dạng EIDR (Entertainment Identifier Registry) đại diện cho một tác phẩm điện ảnh hoặc truyền hình ở cấp độ chung nhất/trừu tượng. Ví dụ: titleEIDR 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ó trên Video theo yêu cầu (VoD), thì bạn phải sử dụng 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 kênh LiveTV, thì bạn không bắt buộc phải sử dụng thuộc tính này; 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ể xuất hiện trên cả VoD và LiveTV. Sử dụng một mảng để chỉ định các đường liên kết sâu khác nhau ở 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 Lý do? URL của 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ộ phim theo định dạng BCP 47.
`genre`	Văn bản	Danh sách theo thứ tự của tất cả cá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. Bạn cũng có thể sử dụng một mảng từ khoá. Ví dụ: ["feature, biography"] 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 Lý do? – `PublicationEvent` được dùng để chỉ định bản phát hành nội dung ban đầu (toàn cầu hoặc cục bộ) của nhà xuất bản, chẳng hạn như ngày phát hành ban đầu tại rạp của một bộ phim. Ngoài ra, hãy sử 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 nội dung gốc, nổi bật, đặc biệt, v.v. `ExclusiveEvent` chỉ đị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ả nơi và thời điểm. Xem phần ví dụ để biết thông tin chi tiết và ví dụ.
`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 những giá trị sau: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Quốc gia	Bắt buộc – Các khu vực được liên kết với 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 nơi nội dung được giới thiệu hoặc độc quyền. Sử dụng mã ISO 3166 cho quốc gia. Để cho biết ở mọi nơi trên thế giới, hãy đặt thành `EARTH`.
`releasedEvent.startDate`	Date hoặc DateTime	Nên dùng – 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`, trường này biểu thị 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 phim đầu tiên tại rạp. Đối với `ExclusiveEvent` và `FeaturedEvent`, trường này biểu thị ngày bắt đầu khi thực thể là độc quyền hoặc được làm nổi bật.
`releasedEvent.endDate`	Date hoặc DateTime	Nên dùng – Bắt buộc đối với `ExclusiveEvent` – Thuộc tính này chỉ áp dụng cho các loại `ExclusiveEvent` và `FeaturedEvent`. Đối với `ExclusiveEvent`, thuộc tính này thể hiện ngày hết hạn quyền đối với nội dung. Đối với `FeaturedEvent`, thuộc tính này thể hiện ngày gần nhất mà nhà cung cấp giới thiệu thực thể. Nếu nội dung là nội dung độc quyền hoặc nội dung được giới thiệu vĩnh viễn, hãy đặt `endDate` thành 20 năm kể từ ngày hiện tại.
`releasedEvent.publishedBy`	Tổ chức hoặc Người	Không bắt buộc – Tổ chức hoặc người đã xuất bản thực thể này.
`description`	Văn bản	Rất nên dùng Lý do? Tóm tắt chương trình. Bạn nên ưu tiên tóm tắt cốt truyện thay vì tóm tắt thông tin thực tế. Giới hạn 300 ký tự. Sử dụng một mảng để đánh dấu nội dung mô tả bằng nhiều ngôn ngữ. Xem ví dụ về Nhiều khu vực và ngôn ngữ.
`actor`	Person hoặc PerformingGroup hoặc PerformanceRole	Rất nên dùng Lý do? Một mảng gồm các diễn viên 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 Lý do? (Các) đạo diễn của chương trình.
`producer`	Tổ chức hoặc Người	Rất nên dùng Lý do? (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 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 `image`, hãy xem phần 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ề Trailer.
`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 phim hoặc nguồn được uỷ quyền tương ứng tải lên.
`trailer.regionsAllowed`	Địa điểm	Các khu vực mà nội dung nghe nhìn được phép xuất hiện. Nếu bạn không chỉ định, thì video này được giả định là được phép xuất hiện ở mọi nơi. Chỉ định các quốc gia ở định dạng ISO 3166.
`identifier`	PropertyValue	Rất nên dùng Lý do? – Giá trị nhận dạng bên ngoài hoặc mã khác giúp nhận dạng rõ ràng thực thể này. Bạn có thể sử dụng nhiều giá trị nhận dạng. Hãy 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 Lý do? Đ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 nội dung khác trong danh mục của bạn; do đó, thang điểm cần phải nhất quán trên các nguồn cấp dữ liệu, trong số 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 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 áp dụng điểm số về mức độ 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 điểm xếp hạng 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` Giá trị này dùng để chỉ định điểm xếp hạng được đưa ra trong bài đánh giá.
`contentRating`	Text (Văn bản) hoặc Rating (Điểm xếp hạng)	Bắt buộc đối với nội dung người lớn, bạn nên làm như vậy đối với nội dung khác – 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ưới dạng chuỗi văn bản, thì hệ thống sẽ chấp nhận hai biến thể: Tên công ty xếp hạng được thêm vào trước điểm xếp hạng, có dấu cách ở giữa. Ví dụ: Mức phân loại "TV-MA" của cơ quan "TVPG" ở Hoa Kỳ phải được mô tả là "TVPG TV-MA". Xem danh sách các công ty quảng cáo. Giá trị "RATING NOT KNOWN" (KHÔNG PHÂN BIỆT CHỮ IN HOA VÀ 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ông ty xếp hạng. Hãy 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ã cảnh báo về nội dung. Các giá trị được chấp nhận bao gồm D, FV, L, S và V. D = Nội dung hội thoại, FV = Nội dung bạo lực giả tưởng, L = Ngôn từ, S = Nội dung tình dục, V = Nội dung bạo lực.

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" biểu thị ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Mỗi ngữ cảnh thực thể gốc phải đặt @language thành mã ngôn ngữ thích hợp ở định dạng BCP 47. Ví dụ: nếu ngôn ngữ được đặt thành tiếng Tây Ban Nha, thì tên sẽ được giả định là 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: Riêng biệt trên toàn bộ 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 đang hoạt động. Dưới 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. Vì `url` của một thực thể đáp ứng tất cả các yêu cầu đối với giá trị nhận dạng, nên bạn nên sử dụng `url` của thực thể làm `@id`. Hãy xem phần Giá trị nhận dạng để biết thêm thông tin chi tiết.
`url`	URL	Bắt buộc – URL chính tắc của nội dung. Google sử dụng URL này để 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. Đối với đườ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 mục tiêu.
`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 bằng nhiều ngôn ngữ. Xem ví dụ về Nhiều ngôn ngữ đại diện. Xin lưu ý rằng mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia) chỉ được hỗ trợ một tên.
`titleEIDR`	Văn bản	Rất nên dùng Lý do? – Giá trị nhận dạng EIDR (Entertainment Identifier Registry) đại diện cho một tác phẩm điện ảnh hoặc truyền hình ở cấp độ chung nhất/trừu tượng. Ví dụ: titleEIDR cho tập đầu tiên của phần đầu tiên của TVSeries có tên "Game of Thrones" là "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
`editEIDR`	Văn bản	Rất nên dùng Lý do? – Giá trị nhận dạng EIDR (Mã đăng ký nhận dạng nội dung giải trí) đại diện cho một bản chỉnh sửa / ấn bản cụ thể của một tác phẩm điện ảnh hoặc truyền hình. Ví dụ: tập đầu tiên của mùa đầu tiên của TVSeries có tên là "Game of Thrones", có titleEIDR là "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", có một bản chỉnh sửa, ví dụ: "10.5240/FB97-C847-2969-D0AB-ECD1-C". Thuộc tính `titleEIDR` là bắt buộc khi bạn cung cấp editEIDR.
`inLanguage`	Văn bản	Ngôn ngữ gốc của bộ phim theo đị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 mỗi mùa; tức là tập đầu tiên của mỗi mùa cần phải là 1.
`partOfSeason`	TVSeason	Bắt buộc – Phần của chương trình truyền hình mà tập này thuộc về. 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`. Giải pháp là: Lấy `partofSeries.@id` (ví dụ: http://www.example.com/my_favorite_tv_show) và đính kèm 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` mà tập này thuộc về.
`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 chứa 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` mà tập này thuộc về.
`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 của 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 sử dụng 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 kênh LiveTV, thì bạn không bắt buộc phải sử dụng thuộc tính này; 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ể xuất hiện trên cả VoD và LiveTV. Sử dụng một mảng để chỉ định các đường liên kết sâu khác nhau ở 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 Lý do? URL	URL của một trang web tham khảo có thể xác định tập đó; ví dụ: 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 lượng 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 Lý do? – `PublicationEvent` dùng để chỉ định bản phát hành nội dung gốc (toàn cầu hoặc cục bộ) của nhà xuất bản, chẳng hạn như ngày phát hành ban đầu của một bộ phim tại rạp. Ngoài ra, hãy sử dụng `FeaturedEvent` để cho biết dịch vụ của bạn tiếp thị nội dung này là nội dung gốc, nổi bật, đặc biệt, v.v. `ExclusiveEvent` chỉ đị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ả nơi và thời điểm. Xem phần ví dụ để biết thông tin chi tiết và ví dụ.
`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 những giá trị sau: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Quốc gia	Bắt buộc – Các khu vực được liên kết với 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 nơi nội dung được giới thiệu hoặc độc quyền. Sử dụng mã ISO 3166 cho quốc gia. Để cho biết ở mọi nơi trên thế giới, hãy đặt thành `EARTH`.
`releasedEvent.startDate`	Date hoặc DateTime	Nên dùng – 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`, trường này biểu thị 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 phim đầu tiên tại rạp. Đối với `ExclusiveEvent` và `FeaturedEvent`, trường này biểu thị ngày bắt đầu khi thực thể là độc quyền hoặc được làm nổi bật.
`releasedEvent.endDate`	Date hoặc DateTime	Nên dùng – Bắt buộc đối với `ExclusiveEvent` – Thuộc tính này chỉ áp dụng cho các loại `ExclusiveEvent` và `FeaturedEvent`. Đối với `ExclusiveEvent`, thuộc tính này thể hiện ngày hết hạn quyền đối với nội dung. Đối với `FeaturedEvent`, thuộc tính này thể hiện ngày gần nhất mà nhà cung cấp giới thiệu thực thể. Nếu nội dung là nội dung độc quyền hoặc nội dung được giới thiệu vĩnh viễn, hãy đặt `endDate` thành 20 năm kể từ ngày hiện tại.
`releasedEvent.publishedBy`	Tổ chức hoặc Người	Không bắt buộc – Tổ chức hoặc người đã xuất bản thực thể này.
`description`	Văn bản	Rất nên dùng Lý do? Tóm tắt nội dung của tập. Bạn nên ưu tiên tóm tắt cốt truyện thay vì tóm tắt thông tin thực tế. Giới hạn 300 ký tự. Sử dụng một mảng để đánh dấu nội dung mô tả bằng nhiều ngôn ngữ. Xem ví dụ về Nhiều ngôn ngữ đại diện.
`genre`	Văn bản	Danh sách theo thứ tự của tất cả cá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. Bạn cũng có thể sử dụng một mảng từ khoá. Ví dụ: ["feature, biography"] 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 Lý do? Một mảng gồm các diễn viên của 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 Lý do? (Các) đạo diễn của tập.
`producer`	Tổ chức hoặc Người	Rất nên dùng Lý do? (Các) nhà sản xuất của phần.
`image`	ImageObject (Đối tượng hình ảnh)	Nên dùng Tại sao? cho Google TV – Nhiều hình ảnh liên quan đến TVEpisode. Để 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 `image`, hãy xem phần 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ề Trailer.
`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 phim hoặc nguồn được uỷ quyền tương ứng tải lên.
`trailer.regionsAllowed`	Địa điểm	Các khu vực mà nội dung nghe nhìn được phép xuất hiện. Nếu bạn không chỉ định, thì video này được giả định là được phép xuất hiện ở mọi nơi. Chỉ định các quốc gia ở định dạng ISO 3166.
`review`	Bài đánh giá	Xem xét mức phân loại của tập phim truyền hình
`review.reviewRating`	Điểm xếp hạng	Bắt buộc nếu bạn cung cấp `review` Giá trị này dùng để chỉ định điểm xếp hạng được đưa ra trong bài đánh giá.
`contentRating`	Text (Văn bản) hoặc Rating (Điểm xếp hạng)	Bắt buộc đối với nội dung người lớn, bạn nên làm như vậy đối với nội dung khác – 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ưới dạng chuỗi văn bản, thì hệ thống sẽ chấp nhận 2 biến thể: Tên công ty xếp hạng được thêm vào trước điểm xếp hạng, có dấu cách ở giữa. Ví dụ: Mức phân loại "TV-MA" của cơ quan "TVPG" ở Hoa Kỳ phải được mô tả là "TVPG TV-MA". Xem danh sách các công ty quảng cáo. Giá trị "RATING NOT KNOWN" (KHÔNG PHÂN BIỆT CHỮ IN HOA VÀ 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ông ty xếp hạng. Hãy 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ã cảnh báo về nội dung. Các giá trị được chấp nhận bao gồm D, FV, L, S và V. D = Nội dung hội thoại, FV = Nội dung bạo lực giả tưởng, L = Ngôn từ, S = Nội dung tình dục, V = Nội dung bạo lực.
`identifier`	PropertyValue	Rất nên dùng Lý do? – Giá trị nhận dạng bên ngoài hoặc mã khác giúp nhận dạng rõ ràng thực thể này. Bạn có thể sử dụng nhiều giá trị nhận dạng. Hãy 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 Lý do? Đ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 nội dung khác trong danh mục của bạn; do đó, thang điểm cần phải nhất quán trên các nguồn cấp dữ liệu, trong số 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 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 áp dụng điểm số về mức độ 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)

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" biểu thị ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Mỗi ngữ cảnh thực thể gốc phải đặt @language thành mã ngôn ngữ thích hợp ở định dạng BCP 47. Ví dụ: nếu ngôn ngữ được đặt thành tiếng Tây Ban Nha, thì tên sẽ được giả định là 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: Riêng biệt trên toàn bộ 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 đang hoạt động. Dưới 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. Vì `url` của một thực thể đáp ứng tất cả các yêu cầu đối với giá trị nhận dạng, nên bạn nên sử dụng `url` của thực thể làm `@id`. Hãy xem phần Giá trị nhận dạng để biết thêm thông tin chi tiết.
`url`	URL	Bắt buộc – URL chính tắc của nội dung. Google sử dụng URL này để 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. Đối với đườ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 mục tiêu.
`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ề Nhiều ngôn ngữ đại diện. Xin lưu ý rằng mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia) chỉ được hỗ trợ một tên.
`titleEIDR`	Văn bản	Rất nên dùng Lý do? – Giá trị nhận dạng EIDR (Entertainment Identifier Registry) đại diện cho một tác phẩm điện ảnh hoặc truyền hình ở cấp độ chung nhất/trừu tượng. Ví dụ: titleEIDR cho phần đầ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ố 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 mà phần này thuộc về.
`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` mà mùa này thuộc về.
`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 của 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 sử dụng 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 kênh LiveTV, thì bạn không bắt buộc phải sử dụng thuộc tính này; 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ể xuất hiện trên cả VoD và LiveTV. Sử dụng một mảng để chỉ định các đường liên kết sâu khác nhau ở 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 Lý do? URL của một trang web tham khảo có thể xác định mùa; ví dụ: trang Wikipedia về 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 Lý do? – `PublicationEvent` dùng để chỉ định bản phát hành nội dung gốc (toàn cầu hoặc cục bộ) của nhà xuất bản, chẳng hạn như ngày phát hành ban đầu của một bộ phim tại rạp. Ngoài ra, hãy sử 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 nội dung gốc, nội dung nổi bật, nội dung đặc biệt, v.v. `ExclusiveEvent` chỉ định rằng dịch vụ của bạn có quyền phân phối độc quyền, bao gồm cả nơi và thời điểm. Xem phần ví dụ để biết thông tin chi tiết và ví dụ.
`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 những giá trị sau: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Quốc gia	Bắt buộc – Các khu vực được liên kết với 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 nơi nội dung được giới thiệu hoặc độc quyền. Sử dụng mã ISO 3166 cho quốc gia. Để cho biết ở mọi nơi trên thế giới, hãy đặt thành `EARTH`.
`releasedEvent.startDate`	Date hoặc DateTime	Nên dùng – 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`, trường này biểu thị 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 phim đầu tiên tại rạp. Đối với `ExclusiveEvent` và `FeaturedEvent`, trường này biểu thị ngày bắt đầu khi thực thể là độc quyền hoặc được làm nổi bật.
`releasedEvent.endDate`	Date hoặc DateTime	Nên dùng – Bắt buộc đối với `ExclusiveEvent` – Thuộc tính này chỉ áp dụng cho các loại `ExclusiveEvent` và `FeaturedEvent`. Đối với `ExclusiveEvent`, thuộc tính này thể hiện ngày hết hạn quyền đối với nội dung. Đối với `FeaturedEvent`, thuộc tính này thể hiện ngày gần nhất mà nhà cung cấp giới thiệu thực thể. Nếu nội dung là nội dung độc quyền hoặc nội dung được giới thiệu vĩnh viễn, hãy đặt `endDate` thành 20 năm kể từ ngày hiện tại.
`releasedEvent.publishedBy`	Tổ chức hoặc Người	Không bắt buộc – Tổ chức hoặc người đã xuất bản thực thể này.
`description`	Văn bản	Rất nên dùng Lý do? Bản tóm tắt về mùa. Bạn nên ưu tiên tóm tắt cốt truyện thay vì tóm tắt thông tin thực tế. Giới hạn 300 ký tự. Sử dụng một mảng để đánh dấu nội dung mô tả bằng nhiều ngôn ngữ. Xem ví dụ về Nhiều ngôn ngữ đại diện.
`actor`	[Person hoặc PerformingGroup hoặc PerformanceRole	Rất nên dùng Lý do? Một mảng gồm các 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 Lý do? Một mảng gồm các đạo diễn của chương trình.
`producer`	Tổ chức hoặc Người	Rất nên dùng Lý do? (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 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 `image`, hãy xem phần Thuộc tính hình ảnh.
`genre`	Văn bản	Danh sách theo thứ tự của tất cả cá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. Bạn cũng có thể sử dụng một mảng từ khoá. Ví dụ: ["feature, biography"] 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ề Trailer.
`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 phim hoặc nguồn được uỷ quyền tương ứng tải lên.
`trailer.regionsAllowed`	Địa điểm	Các khu vực mà nội dung nghe nhìn được phép xuất hiện. Nếu bạn không chỉ định, thì video này được giả định là được phép xuất hiện ở mọi nơi. Chỉ định các quốc gia ở định dạng ISO 3166.
`identifier`	PropertyValue	Rất nên dùng Lý do? – Giá trị nhận dạng bên ngoài hoặc mã khác giúp nhận dạng rõ ràng thực thể này. Bạn có thể sử dụng nhiều giá trị nhận dạng. Hãy 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 Lý do? Đ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 nội dung khác trong danh mục của bạn; do đó, thang điểm cần phải nhất quán trên các nguồn cấp dữ liệu, trong số 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 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 áp dụng điểm số về mức độ 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 điểm xếp hạng 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` Giá trị này dùng để chỉ định điểm xếp hạng được đưa ra trong bài đánh giá.
`contentRating`	Text (Văn bản) hoặc Rating (Điểm xếp hạng)	Bắt buộc đối với nội dung người lớn, bạn nên làm như vậy đối với nội dung khác – 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ưới dạng chuỗi văn bản, thì hệ thống sẽ chấp nhận hai biến thể: Tên công ty xếp hạng được thêm vào trước điểm xếp hạng, có dấu cách ở giữa. Ví dụ: Mức phân loại "TV-MA" của cơ quan "TVPG" ở Hoa Kỳ phải được mô tả là "TVPG TV-MA". Xem danh sách các công ty quảng cáo. Giá trị "RATING NOT KNOWN" (KHÔNG PHÂN BIỆT CHỮ IN HOA VÀ 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ông ty xếp hạng. Hãy 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ã cảnh báo về nội dung. Các giá trị được chấp nhận bao gồm D, FV, L, S và V. D = Nội dung hội thoại, FV = Nội dung bạo lực giả tưởng, L = Ngôn từ, S = Nội dung tình dục, V = Nội dung bạo lực.

Thông số kỹ thuật của đối tượng

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 tên nhân vật và vai diễn của họ trong chương trình truyền hình. (Các) phần sau đây cũng ghi lại điều tương tự, cùng với một số ví dụ làm rõ cách sử dụng.

Thuộc tính Loại dự kiến Mô tả

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 Lý do? : Một mảng gồm các thành viên trong đoàn phim. Sử dụng loại PerformanceRole khi biết vai diễn và (không bắt buộc) tên nhân vật của(các) thành viên trong đoàn diễn. 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ỉ định (các) diễn viên riêng lẻ hoặc PerformingGroup để cung cấp thông tin chi tiết về (các) nhóm nhạc/ban nhạc biểu diễn khi không biết (các) vai diễn của (các) thành viên trong dàn diễn viên. Sử dụng một mảng để biểu thị nhiều Người, Nhóm biểu diễn hoặc Vai trò biểu diễn.

actor

Person hoặc PerformingGroup hoặc PerformanceRole

Rất nên dùng Lý do? : Một mảng gồm các thành viên trong đoàn phim.

Sử dụng loại PerformanceRole khi biết vai diễn và (không bắt buộc) tên nhân vật của(các) thành viên trong đoàn diễn. 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ỉ định (các) diễn viên riêng lẻ hoặc PerformingGroup để cung cấp thông tin chi tiết về (các) nhóm nhạc/ban nhạc biểu diễn khi không biết (các) vai diễn của (các) thành viên trong dàn diễn viên.

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

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

Cung cấp các thuộc tính sau đây 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 Lý do? – Giá trị nhận dạng diễn viên hoặc nhóm diễn xuất ở định dạng URI; ví dụ: https://example.com/actor/abc. `@id` phải đáp ứng các yêu cầu sau: Phải là giá trị duy nhất trên toàn bộ danh mục của bạn cho mỗi diễn viên/nhóm biểu diễn Mã 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 đang hoạt động. Dưới 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 dùng cho giá trị `@id`. Xin lưu ý rằng bạn phải sử dụng `@id` dùng trong thuộc tính diễn viên 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 giống nhau trên hai đối tượng diễn viên này.
`name`	Văn bản	Bắt buộc – Tên của diễn viên/diễn viên nữ/thành viên trong đoàn diễn/nhóm biểu diễn.
`sameAs`	URL	Rất nên dùng Lý do? – URL của một trang web tham khảo có thể xác định diễn viên hoặc nhóm nhạc; ví dụ: trang Wikipedia của 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 Lý do? – Vai diễn do thành viên trong dàn diễn viên đóng, thực hiện hoặc đảm nhậ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 được đóng trong một vai diễn hoặc vai biểu diễn. Đừng đặt trường này nếu loại diễn viên là PerformingGroup.
`actor`	Person hoặc PerformingGroup	Bắt buộc - (Các) thành viên trong dàn diễn viên của nội dung khi sử dụng loại dữ liệu Người. (Các) nhóm nhạc/ban nhạc biểu diễn nội dung khi bạn 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 Lý do? – 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: Phải là giá trị duy nhất trên toàn bộ danh mục của bạn cho mỗi diễn viên/nhóm biểu diễn Mã 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 đang hoạt động. Dưới 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 dùng cho giá trị `@id`. Xin lưu ý rằng bạn phải sử dụng `@id` dùng trong thuộc tính diễn viên 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 giống nhau trên hai đối tượng diễn viên này.
`actor.name`	Văn bản	Bắt buộc – Tên của diễn viên/diễn viên nữ/thành viên trong đoàn diễn/nhóm biểu diễn.
`actor.sameAs`	URL	Rất nên dùng Lý do? – URL của một trang web tham khảo có thể xác định diễn viên hoặc nhóm biểu diễn; ví dụ: trang Wikipedia của diễn viên. Mã 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 phải là Person.

Giá trị `roleName`	Mô tả
"Cameo"	Vai khách mời (cameo) là vai diễ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.
"VoiceActor"	Diễn xuất lồng tiếng 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. Lỗi này thường gặp nhất trong ảnh động, nhưng cũng xảy ra khi lồng tiếng của một diễn viên lồng tiếng cho lời thoại của một diễn viên khác.
"Double"	Người đóng thế là người thay thế 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 và sử dụng thông tin đó để tạo ảnh động cho mô hình nhân vật kỹ thuật số trong ảnh động 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 Person và PerformingGroup.

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

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

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

Ví dụ

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

TVSeries TVEpisode TVSeason

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

{
  "@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"
   }
}

{
  "@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 diễn viên không xác địnhVai trò của diễn viên đã được xác địnhVai trò đã biết cho một nhóm nhỏ diễn viên

Khi không biết vai diễn của một 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 loại 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"
    }
  ]

Khi biết vai diễn 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 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"
      }
  }
]

Khi không biết siêu dữ liệu về vai diễ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 Người hoặc Nhóm biểu diễn . Đối với trường hợp khác mà bạn 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 vào 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"
  }
]

Các trang liên quan

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