电视节目的内容标记属性

本部分详细介绍了 TVSeries、TVEpisode 和 TVSeason 实体类型的内容标记属性。

您可以选择将 TVSeason 作为完整实体提供。如需了解详情，请参阅 TVSeries、TVSeason 和 TVEpisode 关系部分。

规范表

TVSeries

属性	预期类型	说明
@context	文本	必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}] 其中“xx”代表 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为 BCP 47 格式的适当语言代码。例如，如果语言设置为西班牙语，系统会假定名称也是西班牙语，即使字幕/配音语言是英语也是如此。
@type	文本	必需 - 始终设置为 TVSeries。
@id	网址	必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。 @id 必须满足以下要求： 在整个目录中全局唯一 该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。 采用统一资源标识符 (URI) 格式 用于 @id 值的网域必须归贵组织所有。 由于实体的 url 符合作为标识符的所有要求，因此我们建议您将实体的 url 用作 @id。如需了解详情，请参阅标识符部分。
url	网址	必填 - 内容的规范网址。Google 会使用此网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。 url 必须满足以下要求： url 必须是全局唯一的 url 必须包含 Google 可以抓取的有效规范网址。 如需获取播放的深层链接，请改为查看目标对象的 urlTemplate 属性。
name	文本	必需 - 节目名称。 使用数组列出不同语言的名称。请参阅支持多个区域和语言示例。 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
titleEIDR	文本	强烈建议- EIDR（娱乐业标识注册）标识符，在最一般/抽象层面上表示电影或电视作品。 例如，名为“权力的游戏”的电视剧的 titleEIDR 为“10.5240/C1B5-3BA1-8991-A571-8472-W”。
potentialAction	WatchAction	如果适用，则必须提供 - 一个操作标记对象，用于提供操作的详细信息。 如果内容可在视频点播 (VoD) 平台上播放，则必须提供此属性；Action 标记对象需要提供相应内容的深层链接。 如果内容在 LiveTV 频道上提供，则此属性为可选属性；关联的 BroadcastService 实体会改为提供频道的深层链接。 TVSeries 可同时用于 VOD 和直播电视。 使用数组指定多个区域中的不同深层链接。请参阅支持多个区域和语言示例。
sameAs	网址	强烈建议指向可识别节目的参考网页的网址；例如，节目的维基百科页面。此属性必须与 url 属性不同。
inLanguage	文本	系列图书的原始语言，采用 BCP 47 格式。
genre	文本	所有相关类型的有序列表。例如：["Action", "Fashion", "Environment", "Football"]
keywords	文本	用于描述此内容的关键字或标签。还允许使用关键字数组。例如，["feature, biography"] 可以是用于描述内容的关键字数组。
releasedEvent	PublicationEvent、FeaturedEvent 或 ExclusiveEvent	强烈建议- PublicationEvent 用于指定发布商的原始（全球或本地）内容发布日期，例如电影的原始影院上映日期。 此外，使用 FeaturedEvent 可指明您的服务将此内容作为原创内容、精选内容、特别内容等进行营销。 ExclusiveEvent 用于指定您的服务拥有独家分销权，并包含分销地点和时间。 如需了解详情和示例，请参阅示例部分。
releasedEvent.@type	文本	必需 - 请务必始终将此属性设置为以下各项之一： PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	国家/地区	必填 - 与此活动相关联的地区。 对于 PublicationEvent，这是内容的发布地区。 对于 FeaturedEvent 和 ExclusiveEvent，这是内容的专题或独家地区。 请使用 ISO 3166 代码来表示国家/地区。如需指明世界各地，请设置为 EARTH。
releasedEvent.startDate	Date 或 DateTime	推荐 - 对于 ExclusiveEvent 为必填 - 实体发布的开始日期。 对于 PublicationEvent，此属性表示此实体的初始发布日期，例如电影首次在影院上映的日期。 对于 ExclusiveEvent 和 FeaturedEvent，此属性表示实体作为独家或精选内容的开始日期。
releasedEvent.endDate	Date 或 DateTime	推荐 - 对于 ExclusiveEvent，此属性为必填 - 此属性仅适用于 ExclusiveEvent 和 FeaturedEvent 类型。 对于 ExclusiveEvent，此属性表示内容的权利到期日期。 对于 FeaturedEvent，此属性表示提供商上次精选相应实体的时间。 如果内容是永久性独家内容或精选内容，请将 endDate 设置为距离当前日期 20 年。
releasedEvent.publishedBy	组织或个人	可选 - 发布此实体的组织或个人。
description	文本	强烈建议节目的剧情简介。最好提供剧情摘要，而不是事实摘要。字符数限制为 300 个字符。 使用数组以多种语言标记说明。请参阅支持多个区域和语言示例。
actor	Person 或 PerformingGroup 或 PerformanceRole	强烈建议剧集演员阵容的数组。如需查看建模指南，请点击此处。
director	Person	强烈建议节目的导演。
producer	组织或个人	强烈建议节目的制作人。
image	ImageObject	对于 Google TV 是必需的：与 TVSeries 相关的图片。如需详细了解应与 image 一起添加的必需属性和可选属性，请参阅图片属性。
trailer.description	文本	预告片的说明。请参阅预告片示例。
trailer.inLanguage	文本	预告片的语言（采用 BCP 47 格式）。
trailer.url	网址	由相应制作工作室或授权来源公开托管并上传的预告片的网址。
trailer.regionsAllowed	Place	允许显示该媒体的区域。如果未指定，则假定允许在所有地方显示该视频。以 ISO 3166 格式指定国家/地区。
identifier	PropertyValue	强烈建议- 明确标识了此实体的外部 ID 或其他 ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。
popularityScore	PopularityScoreSpecification	强烈建议一种得分，Google 会根据该得分以及其他信号来确定向用户播放哪种媒体。此评分表示相应内容相对于目录中其他内容的热门程度；因此，您 Feed 中所有实体以及目录中所有实体的评分比例需要保持一致。默认情况下，实体的热门程度得分设为 0。
popularityScore.@type	文本	始终设置为 PopularityScoreSpecification。
popularityScore.value	编号	一个非负数值，表示实体的受欢迎程度；得分越高，受欢迎程度越高。
popularityScore.eligibleRegion	国家/地区	此人气指数适用的地区。如果热门程度得分适用于全球，请设为 EARTH。默认情况下，此属性设置为 EARTH。 Note: 特定语言区域的热门程度优先于全球（地球）热门程度
review	Review	查看电视连续剧的分级
review.reviewRating	评分	如果提供了 review，则必须使用此属性。此属性用于指定评价中的评分。
contentRating	Text 或 Rating	对于成人内容为必填，对于其他内容强烈建议填写 - 总体内容分级。如果内容分级以文本字符串的形式提供，则接受以下两种变体： 分级机构，位于分级前面，中间有空格。例如，美国机构“TVPG”的“TV-MA”分级应描述为“TVPG TV-MA”。请参阅代理机构列表。 值为“RATING NOT KNOWN”（不区分大小写），表示您不知道相应内容的分级。
contentRating.author	组织	如果 contentRating 使用 Rating，则必填 - 分级机构的名称。请参阅内容分级机构页面，查看接受的分级机构列表
contentRating.ratingValue	文本	如果 contentRating 使用 Rating，则必需 - 分级的值。
contentRating.advisoryCode	文本	内容的警示代码。接受的值包括 D、FV、L、S 和 V。D = 对话、FV = 幻想暴力、L = 语言、S = 色情内容、V = 暴力。

TVEpisode

属性	预期类型	说明
@context	文本	必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}] 其中“xx”代表 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为 BCP 47 格式的适当语言代码。例如，如果语言设置为西班牙语，系统会假定名称也是西班牙语，即使字幕/配音语言是英语也是如此。
@type	文本	必需 - 始终设置为 TVEpisode。
@id	网址	必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。 @id 必须满足以下要求： 在整个目录中全局唯一 该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。 采用统一资源标识符 (URI) 格式 用于 @id 值的网域必须归贵组织所有。 由于实体的 url 符合作为标识符的所有要求，因此我们建议您将实体的 url 用作 @id。如需了解详情，请参阅标识符部分。
url	网址	必填 - 内容的规范网址。Google 会使用此网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。 url 必须满足以下要求： url 必须是全局唯一的 url 必须包含 Google 可以抓取的有效规范网址。 如需获取播放的深层链接，请改为查看目标对象的 urlTemplate 属性。
name	文本	必填 - 剧集的名称。 使用数组列出不同语言的名称。请参阅多语言表示示例。 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
titleEIDR	文本	强烈建议- EIDR（娱乐业标识注册）标识符，在最一般/抽象层面上表示影视作品。 例如，名为“权力的游戏”的电视剧第一季第一集的 titleEIDR 为“10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”。
editEIDR	文本	强烈建议- EIDR（娱乐业标识注册）标识符，表示影视作品的特定剪辑 / 版本。 例如，名为“权力的游戏”的电视剧系列第一季的第一集的标题 EIDR 为“10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”，其中包含一个剪辑版本，例如“10.5240/FB97-C847-2969-D0AB-ECD1-C”。提供 editEIDR 时， titleEIDR 属性为必需属性。
inLanguage	文本	系列图书的原始语言，采用 BCP 47 格式。
episodeNumber	整数	必填 - 此编号表示此剧集在剧季中剧集顺序中的位置。episodeNumber 需要针对每个季节重置；也就是说，每个季节的第一集需要为 1。
partOfSeason	TVSeason	必需 - 此剧集所属的电视剧季。 即使 TVEpisode 没有对应的 TVSeason，您仍然需要提供 partOfSeason.@id 和 partOfSeason.seasonNumber 属性。临时解决方法是： 获取 partofSeries.@id（例如 http://www.example.com/my_favorite_tv_show），并附加占位符查询字段（例如 ?season1），以创建唯一的 partOfSeason.@id（例如 http://www.example.com/my_favorite_tv_show?season1）。 将 partOfSeason.seasonNumber 设置为 1。
partOfSeason.@type	文本	必需 - 始终设置为 TVSeason。
partOfSeason.@id	网址	必填 - 此剧集所属的 TVSeason 的 @id。
partOfSeason.seasonNumber	整数	必填 - 一个数字，表示此剧季在电视连续剧的剧季顺序中的排名。
partOfSeries	TVSeries	必填 - 此剧集所属的电视连续剧。
partOfSeries.@type	文本	必需 - 始终设置为 TVSeries。
partOfSeries.@id	网址	必填 - 此剧集所属的 TVSeries 的 @id。
partOfSeries.name	文本	必填 - 电视连续剧的名称。
partOfSeries.sameAs	文本	指向可识别节目的参考网页的网址；例如，节目的维基百科页面。此属性必须与 url 属性不同。
potentialAction	WatchAction	如果适用，则必须提供 - 一个操作标记对象，用于提供操作的详细信息。 如果内容可在视频点播 (VoD) 平台上播放，则必须提供此属性；Action 标记对象需要提供相应内容的深层链接。 如果内容在 LiveTV 频道上提供，则此属性为可选属性；关联的 BroadcastService 实体会改为提供频道的深层链接。 TVEpisode 可同时用于 VOD 和直播电视。 使用数组指定多个区域中的不同深层链接。请参阅支持多个区域和语言示例。
sameAs	强烈建议网址	可识别分集的参考网页的网址；例如，分集的维基百科页面。此属性必须与 url 属性不同。
duration	时长	剧集的时长，采用 ISO 8601 格式。请使用以下格式：“PT00H00M”。
releasedEvent	PublicationEvent、FeaturedEvent 或 ExclusiveEvent	强烈建议- PublicationEvent 用于指定发布商的原始（全球或本地）内容发布日期，例如电影的原始影院上映日期。 此外，使用 FeaturedEvent 可指明您的服务将此内容作为原创内容、精选内容、特别内容等进行营销。 ExclusiveEvent 用于指定您的服务拥有独家分销权，并包含分销地点和时间。 如需了解详情和示例，请参阅示例部分。
releasedEvent.@type	文本	必需 - 请务必始终将此属性设置为以下各项之一： PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	国家/地区	必填 - 与此活动相关联的地区。 对于 PublicationEvent，这是内容的发布地区。 对于 FeaturedEvent 和 ExclusiveEvent，这是内容的专题或独家地区。 请使用 ISO 3166 代码来表示国家/地区。如需指明世界各地，请设置为 EARTH。
releasedEvent.startDate	Date 或 DateTime	推荐 - 对于 ExclusiveEvent 为必填 - 实体发布的开始日期。 对于 PublicationEvent，此属性表示此实体的初始发布日期，例如电影首次在影院上映的日期。 对于 ExclusiveEvent 和 FeaturedEvent，此属性表示实体成为独家或精选内容的开始日期。
releasedEvent.endDate	Date 或 DateTime	推荐 - 对于 ExclusiveEvent，此属性为必填 - 此属性仅适用于 ExclusiveEvent 和 FeaturedEvent 类型。 对于 ExclusiveEvent，此属性表示内容的权利到期日期。 对于 FeaturedEvent，此属性表示提供商上次精选相应实体内容的日期。 如果内容是永久性独家内容或精选内容，请将 endDate 设置为距离当前日期 20 年。
releasedEvent.publishedBy	组织或个人	可选 - 发布此实体的组织或个人。
description	文本	强烈建议剧集的摘要。最好提供剧情摘要，而不是事实摘要。字符数限制为 300 个字符。 使用数组以多种语言标记说明。请参阅多语言表示示例。
genre	文本	所有相关类型的有序列表。例如：["Action", "Fashion", "Environment", "Football"]
keywords	文本	用于描述此内容的关键字或标签。还允许使用关键字数组。例如，["feature, biography"] 可以是用于描述内容的关键字数组。
actor	Person 或 PerformingGroup 或 PerformanceRole	强烈建议剧集演员的数组。如需查看建模指南，请点击此处。
director	Person	强烈建议剧集的导演。
producer	组织或个人	强烈建议剧季的制作人。
image	ImageObject	强烈建议为 Google TV 提供 - 与剧集相关的各种图片。如需详细了解应与 image 一起添加的必需属性和可选属性，请参阅图片属性。
trailer.description	文本	预告片的说明。请参阅预告片示例。
trailer.inLanguage	文本	预告片的语言（采用 BCP 47 格式）。
trailer.url	网址	由相应制作工作室或授权来源公开托管并上传的预告片的网址。
trailer.regionsAllowed	Place	允许显示该媒体的区域。如果未指定，则假定允许在所有地方显示该视频。以 ISO 3166 格式指定国家/地区。
review	Review	查看电视剧分集的分级
review.reviewRating	评分	如果提供了 review，则必须使用此属性。此属性用于指定评价中的评分。
contentRating	Text 或 Rating	对于成人内容为必填，对于其他内容强烈建议填写 - 总体内容分级。如果内容分级以文本字符串的形式提供，则接受以下两种变体： 分级机构，位于分级前面，中间有空格。例如，美国机构“TVPG”的“TV-MA”分级应描述为“TVPG TV-MA”。请参阅代理机构列表。 值为“RATING NOT KNOWN”（不区分大小写），表示您不知道相应内容的分级。
contentRating.author	组织	如果 contentRating 使用 Rating，则必填 - 分级机构的名称。请参阅内容分级机构页面，查看接受的分级机构列表
contentRating.ratingValue	文本	如果 contentRating 使用 Rating，则必需 - 分级的值。
contentRating.advisoryCode	文本	内容的警示代码。接受的值包括 D、FV、L、S 和 V。D = 对话、FV = 幻想暴力、L = 语言、S = 色情内容、V = 暴力。
identifier	PropertyValue	强烈建议- 明确标识了此实体的外部 ID 或其他 ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。
popularityScore	PopularityScoreSpecification	强烈建议一种得分，Google 会根据该得分以及其他信号来确定向用户播放哪种媒体。此评分表示相应内容相对于目录中其他内容的热门程度；因此，您 Feed 中所有实体以及目录中所有实体的评分比例需要保持一致。默认情况下，实体的热门程度得分设为 0。
popularityScore.@type	文本	始终设置为 PopularityScoreSpecification。
popularityScore.value	编号	一个非负数值，表示实体的受欢迎程度；得分越高，受欢迎程度越高。
popularityScore.eligibleRegion	国家/地区	此人气指数适用的地区。如果热门程度得分适用于全球，请设为 EARTH。默认情况下，此属性设置为 EARTH。 Note: 特定语言区域的热门程度优先于全球（地球）热门程度

TVSeason

属性	预期类型	说明
@context	文本	必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}] 其中“xx”代表 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为 BCP 47 格式的适当语言代码。例如，如果语言设置为西班牙语，系统会假定名称也是西班牙语，即使字幕/配音语言是英语也是如此。
@type	文本	必需 - 始终设置为 TVSeason。
@id	网址	必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。 @id 必须满足以下要求： 在整个目录中全局唯一 该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。 采用统一资源标识符 (URI) 格式 用于 @id 值的网域必须归贵组织所有。 由于实体的 url 符合作为标识符的所有要求，因此我们建议您将实体的 url 用作 @id。如需了解详情，请参阅标识符部分。
url	网址	必填 - 内容的规范网址。Google 会使用此网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。 url 必须满足以下要求： url 必须是全局唯一的 url 必须包含 Google 可以抓取的有效规范网址。 如需获取播放的深层链接，请改为查看目标对象的 urlTemplate 属性。
name	文本	必填 - 此电视剧季的名称。 使用数组列出不同语言的名称。请参阅多语言表示示例。 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
titleEIDR	文本	强烈建议- EIDR（娱乐业标识注册）标识符，在最一般/抽象层面上表示影视作品。 例如，名为“权力的游戏”的电视连续剧第一季的 titleEIDR 为“10.5240/FD91-C72C-4161-FCBA-058B-1”。
seasonNumber	整数	必填 - 一个数字，表示此剧季在电视连续剧的剧季顺序中的排名。
partOfSeries	TVSeries	必需 - 此剧季所属的电视连续剧。
partOfSeries.@type	文本	必需 - 始终设置为 TVSeries。
partOfSeries.@id	网址	必需 - 此剧季所属的 TVSeries 的 @id。
partOfSeries.name	文本	必填 - 电视连续剧的名称。
partOfSeries.sameAs	文本	指向可识别节目的参考网页的网址；例如，节目的维基百科页面。此属性必须与 url 属性不同。
potentialAction	WatchAction	如果适用，则必须提供 - 一个操作标记对象，用于提供操作的详细信息。 如果内容可在视频点播 (VoD) 平台上播放，则必须提供此属性；Action 标记对象需要提供相应内容的深层链接。 如果内容在 LiveTV 频道上提供，则此属性为可选属性；关联的 BroadcastService 实体会改为提供频道的深层链接。 TVSeason 可同时用于 VOD 和直播电视。 使用数组指定多个区域中的不同深层链接。请参阅支持多个区域和语言示例。
sameAs	网址	强烈建议可识别赛季的参考网页的网址；例如，赛季的维基百科页面。此属性必须与 url 属性不同。
releasedEvent	PublicationEvent、FeaturedEvent 或 ExclusiveEvent	强烈建议- PublicationEvent 用于指定发布商的原始（全球或本地）内容发布日期，例如电影的原始影院上映日期。 此外，使用 FeaturedEvent 表示您的服务将此内容作为原创内容、精选内容、特别内容等进行营销。 ExclusiveEvent 用于指定您的服务拥有独家分销权，并包含分销地点和时间。 如需了解详情和示例，请参阅示例部分。
releasedEvent.@type	文本	必需 - 请务必始终将此属性设置为以下各项之一： PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	国家/地区	必填 - 与此活动相关联的地区。 对于 PublicationEvent，这是内容的发布地区。 对于 FeaturedEvent 和 ExclusiveEvent，这是内容的专题或独家地区。 请使用 ISO 3166 代码来表示国家/地区。如需指明世界各地，请设置为 EARTH。
releasedEvent.startDate	Date 或 DateTime	推荐 - 对于 ExclusiveEvent 为必填 - 实体发布的开始日期。 对于 PublicationEvent，此属性表示此实体的初始发布日期，例如电影首次在影院上映的日期。 对于 ExclusiveEvent 和 FeaturedEvent，此属性表示实体成为独家或精选内容的开始日期。
releasedEvent.endDate	Date 或 DateTime	推荐 - 对于 ExclusiveEvent，此属性为必填 - 此属性仅适用于 ExclusiveEvent 和 FeaturedEvent 类型。 对于 ExclusiveEvent，此属性表示内容的权利到期日期。 对于 FeaturedEvent，此属性表示提供商上次精选相应实体的时间。 如果内容是永久性独家内容或精选内容，请将 endDate 设置为距离当前日期 20 年。
releasedEvent.publishedBy	组织或个人	可选 - 发布此实体的组织或个人。
description	文本	强烈建议剧季的剧情摘要。最好提供剧情摘要，而不是事实摘要。字符数限制为 300 个字符。 使用数组以多种语言标记说明。请参阅多语言表示示例。
actor	[Person 或 PerformingGroup 或 PerformanceRole	强烈建议剧季演员阵容的数组。如需查看建模指南，请点击此处。
director	Person	强烈建议节目导演的数组。
producer	组织或个人	强烈建议剧季的制作人。
image	ImageObject	与电视剧季相关的图片。如需详细了解应与 image 一起添加的必需属性和可选属性，请参阅图片属性。
genre	文本	所有相关类型的有序列表。例如：["Action", "Fashion", "Environment", "Football"]
keywords	文本	用于描述此内容的关键字或标签。还允许使用关键字数组。例如，["feature, biography"] 可以是用于描述内容的关键字数组。
trailer.description	文本	预告片的说明。请参阅预告片示例。
trailer.inLanguage	文本	预告片的语言（采用 BCP 47 格式）。
trailer.url	网址	由相应制作工作室或授权来源公开托管并上传的预告片的网址。
trailer.regionsAllowed	Place	允许显示该媒体的区域。如果未指定，则假定允许在所有地方显示该视频。以 ISO 3166 格式指定国家/地区。
identifier	PropertyValue	强烈建议- 明确标识了此实体的外部 ID 或其他 ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。
popularityScore	PopularityScoreSpecification	强烈建议一种得分，Google 会根据该得分以及其他信号来确定向用户播放哪种媒体。此评分表示相应内容相对于目录中其他内容的热门程度；因此，您 Feed 中所有实体以及目录中所有实体的评分比例需要保持一致。默认情况下，实体的热门程度得分设为 0。
popularityScore.@type	文本	始终设置为 PopularityScoreSpecification。
popularityScore.value	编号	一个非负数值，表示实体的受欢迎程度；得分越高，受欢迎程度越高。
popularityScore.eligibleRegion	国家/地区	此人气指数适用的地区。如果热门程度得分适用于全球，请设为 EARTH。默认情况下，此属性设置为 EARTH。 Note: 特定语言区域的热门程度优先于全球（地球）热门程度
review	Review	查看电视剧季的评分
review.reviewRating	评分	如果提供了 review，则必须使用此属性。此属性用于指定评价中的评分。
contentRating	Text 或 Rating	对于成人内容为必填，对于其他内容强烈建议填写 - 总体内容分级。如果内容分级以文本字符串的形式提供，则接受以下两种变体： 分级机构，位于分级前面，中间有空格。例如，美国机构“TVPG”的“TV-MA”分级应描述为“TVPG TV-MA”。请参阅代理机构列表。 值为“RATING NOT KNOWN”（不区分大小写），表示您不知道相应内容的分级。
contentRating.author	组织	如果 contentRating 使用 Rating，则必填 - 分级机构的名称。请参阅内容分级机构页面，查看接受的分级机构列表
contentRating.ratingValue	文本	如果 contentRating 使用 Rating，则必需 - 分级的值。
contentRating.advisoryCode	文本	内容的警示代码。接受的值包括 D、FV、L、S 和 V。D = 对话、FV = 幻想暴力、L = 语言、S = 色情内容、V = 暴力。

执行器规范

借助 TVSeries、TVEpisode 和 TVSeason 实体类型中的 actor 属性，您可以指定有关演员的更多详细信息，包括其角色的名称以及他们在电视节目中的角色。以下部分也介绍了相同的内容，并提供了一些示例来阐明用法。

属性	预期类型	说明
actor	Person 或 PerformingGroup 或 PerformanceRole	强烈建议：演员阵容的数组。 如果已知演员所扮演的角色以及（可选）演员的角色名称，请使用类型 PerformanceRole。在本例中，操作者 Person 或 PerformingGroup 嵌入在 PerformanceRole 对象中。 当演员的角色未知时，请使用类型 Person 指明个人演员，或使用 PerformingGroup 提供表演团体/乐队的详细信息。 使用数组表示多个 Person、PerformingGroup 或 PerformanceRole。

使用 Person 或 PerformingGroup 类型

使用 Person 或 PerformingGroup 类型时，请提供以下属性

属性	预期类型	说明
@type	Person 或 PerformingGroup	必需 - 始终设置为 Person 或 PerformingGroup
@id	网址	强烈建议- 演员或表演团体标识符（采用 URI 格式）；例如，https://example.com/actor/abc。@id 必须符合以下要求： 在您的目录中，每个演员/表演团体都有一个全局唯一的 ID 该 ID 应保持稳定，不应随着时间的推移而发生变化。它将被视为不透明字符串，且不必是有效链接。 采用统一资源标识符 (URI) 格式 用于 @id 值的网域必须归贵组织所有。 请注意，在 actor 属性中使用的 @id 应在整个 Feed 中保持一致。例如，如果有两部电影都包含同一演员，则这两个演员对象的 @id 值应保持一致。
name	文本	必填 - 演员/演员/演员阵容/表演团体的姓名。
sameAs	网址	强烈建议- 可识别演员或表演团体的参考网页的网址；例如，演员的维基百科网页。此属性必须与 @id 属性不同。

使用 PerformanceRole 类型

使用 PerformanceRole 类型时，请提供以下属性

属性	预期类型	说明
@type	PerformanceRole	必需 - 始终设置为 PerformanceRole
roleName	文本	强烈建议- 由演员扮演、表演或填补的角色。请点击此处查看可接受的值列表。
characterName	文本	在某种表演或表演角色中扮演的角色的名称。如果演员类型为 PerformingGroup，请勿设置此字段。
actor	Person 或 PerformingGroup	必填 - 使用数据类型 Person 时，内容的演员。 使用数据类型 PerformingGroup 时，内容的表演团体/乐队。
actor.@type	Person 或 PerformingGroup	必需 - 始终设置为 Person 或 PerformingGroup
actor.@id	网址	强烈建议- 演员或表演团体标识符（采用 URI 格式）；例如，https://example.com/actor/abc。@id 必须符合以下要求： 在您的目录中，每个演员/表演团体都有一个全局唯一的 ID 该 ID 应保持稳定，不应随着时间的推移而发生变化。它将被视为不透明字符串，且不必是有效链接。 采用统一资源标识符 (URI) 格式 用于 @id 值的网域必须归贵组织所有。 请注意，在 actor 属性中使用的 @id 应在整个 Feed 中保持一致。例如，如果有两部电影都包含同一演员，则这两个演员对象的 @id 值应保持一致。
actor.name	文本	必填 - 演员/演员/演员阵容/表演团体的姓名。
actor.sameAs	网址	强烈建议- 可识别演员或表演团体的参考网页的网址；例如，演员的维基百科网页。此 ID 必须不同于 actor.@id 属性。

可接受的角色名称

这些值要求 actor.@type 为 Person。

roleName 值	说明
“Cameo”	客串角色（也称为客串演出）是指知名人士在表演艺术作品中短暂亮相。
“VoiceActor”	声音表演是指使用演员的声音，但演员不会出现在屏幕上。这种情况最常见于动画中，但当演员的声音被配音到另一个演员的对白中时也会出现这种情况。
“Double”	替身演员是指代替其他演员表演的演员，其面部不会出现在画面中。
“MotionCaptureActor”	MotionCaptureActor 是指录制真人演员动作并使用这些信息在二维或三维计算机动画中为数字角色模型添加动画效果的人员。

这些值通常适用于 Person 和 PerformingGroup 类型。

roleName 值	说明
“Actor”	演员是指在传统的剧院媒体或电影、广播和电视等现代媒体中表演角色的人。
“GuestStar”	“客串演员是指扮演虚构角色并出现在一个或几个剧集中的演员。在某些情况下，尽管不是主要演员，但客串演员也可能会扮演重要且反复出现的角色，并可能会在连续剧中多次出现。如果演员是节目的嘉宾或客串演员，请将此值设为“GuestStar”。客串演员只能在剧集级别提供，不得在电视剧级别添加。
“访客”	“A guest on a talk show. 请注意，“客串演员”是虚构角色，“嘉宾”是真实身份。
“Announcer”（播报员）	播报员负责播报节目的开场白和结尾白，介绍主持人、参赛者和/或名人嘉宾，介绍可赢取的奖品，并在录制前为观众热身，在广告插播期间为他们提供娱乐节目。
“评论者”	解说员通常在直播期间对比赛或活动进行实时解说。
“印象派”	模仿艺人是指模仿名人和卡通人物的声音、语气和举止的表演者。
“主机”	主持、介绍或播放电视节目的人员，通常充当节目与观众之间的中介。“主持人”通常是纪实类角色。
“CoHost”	与他人共同举办活动/计划的人员。
“GuestHost”	嘉宾主持人通常是谈话节目的主持人，在常规主持人无法主持节目时，他们会代替常规主持人主持节目。
“新闻播报员”	通过电视新闻节目向公众介绍/告知本地、国内和国际范围内发生的新闻和事件的人员。
“特派记者”	特派记者或现场记者通常是杂志的记者或评论员，或者是从偏远（通常是遥远）地点为报纸、广播或电视新闻或其他类型的公司撰写报道的代理。
“ShowJudge”	评委通常被视为节目领域的专家，并被赋予“评委”角色，负责对参加电视连续剧试镜并参与比赛的选手进行评判。
“Panelist”	电台或电视节目讨论或咨询小组的成员。
“参赛者”	竞赛或游戏节目的参赛者是指参与其中的人员。
“StoryNarrator”	讲述者是指讲述某事的人，尤其是指重述小说或叙事诗中事件的角色
“MusicalArtist”	“音乐人可以是个人、群体或虚构人物，通常会定期在观众面前表演，或者录制音乐曲目或音乐专辑。只有在某些音乐作品的演职员表暗示作曲家和词作者也作为主要表演者做出贡献时，才应为他们指定此类型。此类型可用于将固定音乐人或音乐人群体以及嘉宾音乐人或音乐人群体与节目相关联。

区分演员的主角和配角

如需区分电视节目中的主演/常驻演员和客串/配角，请仅在 TVSeries 实体中添加主演，并仅在 TVEpisode 实体中添加客串演员或配角。确保主演/常规演员未添加到 TVEpisode 实体中。

示例

TVSeries、TVEpisode 和 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"
    }
  ]
}

Actor 属性示例

操作者的角色未知

如果演员的角色未知，我们建议您只使用 Person 或 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"
    }
  ]

已知操作者的角色

如果已知演员的角色，建议使用 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"
      }
  }
]

部分演员的已知角色

如果不清楚表演角色元数据，建议您使用 人员 或 表演团体 类型提供演员信息。对于已知此信息的其他情况，请使用 PerformanceRole 类型。这些类型可以一起添加到同一数组中。

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

相关页面

如需了解与这些媒体资源相关的主题，请参阅以下页面：

• 确定内容的实体类型
• 收集内容的 ID、网址和名称
• 确定电视连续剧、电视剧季和电视剧集之间的关系
• 收集内容的元数据