电视节目的内容标记属性

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

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

规范表

电视连续剧

属性	预期类型	说明
@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（娱乐标识符注册）标识符，代表最一般/抽象级别的电影或电视作品。 例如，电视剧《权利的游戏》的标题为“EIDR”为“10.5240/C1B5-3BA1-8991-A571-8472-W”。
potentialAction	WatchAction	必需（如果适用） - 操作标记对象，用于提供操作的详细信息。 如果内容是视频点播 (VoD) 内容，则必须提供此属性；操作标记对象需要提供该内容的深层链接。 如果相应内容可通过 LiveTV 频道观看，则此属性为可选属性；关联的 BroadcastService 实体提供频道的深层链接。 TVSeries 可在 VoD 和 LiveTV 中使用。 使用数组可在多个区域指定不同的深层链接。请参阅多个区域和语言示例。
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	日期或日期时间	建议 - ExclusiveEvent 要求填写 - 实体出版的开始日期。 PublicationEvent 表示实体首次发行的日期，例如电影首次上映的日期。 对于 ExclusiveEvent 和 FeaturedEvent，这代表实体开始独占或精选展示的开始日期。
releasedEvent.endDate	日期或日期时间	推荐 - 对于 ExclusiveEvent 为必需项 - 这仅适用于 ExclusiveEvent 和 FeaturedEvent 类型。 对于 ExclusiveEvent，这代表内容权利到期的日期。 对于 FeaturedEvent，这是指提供商永久性展示相应实体的最后日期。 如果内容永久保留或显示为精选内容，请将 endDate 设为自当前日期起的 20 年后。
releasedEvent.publishedBy	组织或个人	可选 - 发布此实体的组织或个人。
description	文本	强烈建议原因节目的剧情简介。情节摘要比事实摘要更受欢迎。字符数限制为 300 个。 使用数组标记多种语言的说明。请参阅多个区域和语言示例。
actor	Person、PerformingGroup 或 PerformanceRole	强烈建议原因该系列中投射成员的数组。请参阅此处的建模指南。
director	人称	强烈建议原因节目的导演。
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	热门程度得分规范	强烈建议原因Google 根据这一得分及其他一些信号来确定为用户播放哪种媒体内容。此得分表示内容相对于您目录中其他内容的受欢迎程度；因此，该得分在各 Feed 之间在目录中的所有实体中必须保持一致。默认情况下，实体的热门程度分数设为 0。
popularityScore.@type	文本	始终设置为 PopularityScoreSpecification。
popularityScore.value	编号	非负数值，表示实体的热门程度；分数越高，表示热门程度越高。
popularityScore.eligibleRegion	国家/地区	此热门程度得分适用的地区。如果热门程度得分是全球适用的，则设为 EARTH。默认情况下，此属性会设置为 EARTH。 Note: 针对特定语言区域的热门程度高于全球 (EARTH) 热门程度
review	Review	查看电视连续剧的评分
review.reviewRating	评分	如果提供了 review，则必须提供此属性：用于指定评价中提供的评分。
contentRating	文字或评分	需要成人内容，否则强烈建议 - 总体内容分级。如果内容分级是以文本字符串的形式提供的，则会接受两种变体： 分级机构在分级前面附加了空白字符。例如，美国的代理机构“TVPG”所给出的“TV-MA”分级应描述为“TVPG TV-MA”。请参阅代理机构列表。 值“分级未知”（不区分大小写），表示您不知道该内容的分级。
contentRating.author	文字或组织	如果 contentRating 使用 Rating，则为必需项 - 分级机构的名称。如需查看可接受的分级代理机构列表，请参阅内容分级代理机构页面。
contentRating.ratingValue	文本	如果 contentRating 使用 Rating，则为必需值 - 评分的值。
contentRating.advisoryCode	文本	内容的建议代码。接受的值包括 D、FV、L、S 和 V；D = 对话、FV = 幻想暴力内容、L = 语言、S = 色情内容、V = 暴力内容。

电视剧集

属性	预期类型	说明
@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”，有 1 次修改，例如“10.5240/FB97-C847-C847-C847-C847-C847-C847-C847-C847-C847-C847-C847-C847-C847-C847-C847-C847-C847-C84 titleEIDR 属性在提供 EditEIDR 时是必需的。
inLanguage	文本	该系列的原始语言（采用 BCP 47 格式）。
episodeNumber	整数	必需 - 用于指示此剧集排名的编号（按剧季中的剧集顺序排列）。“episodeNumber”需要针对每个剧季重新开始；也就是说，每个剧季的第一集需要为 1。
partOfSeason	电视季	必需 - 此剧集所属的电视剧季。 即使 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	电视连续剧	必需 - 此剧集所属的电视连续剧。
partOfSeries.@type	文本	必需 - 始终设置为 TVSeries。
partOfSeries.@id	网址	必需 - 此分集所属的 TVSeries 的 @id。
partOfSeries.name	文本	必需 - 电视连续剧的名称。
partOfSeries.sameAs	文本	可标识节目的参考网页的网址，例如节目的维基百科页面。此属性必须与 url 属性不同。
potentialAction	WatchAction	必需（如果适用） - 操作标记对象，用于提供操作的详细信息。 如果内容是视频点播 (VoD) 内容，则必须提供此属性；操作标记对象需要提供该内容的深层链接。 如果相应内容可通过 LiveTV 频道观看，则此属性为可选属性；关联的 BroadcastService 实体提供频道的深层链接。 TVEpisode 可在 VoD 和 LiveTV 中使用。 使用数组可在多个区域指定不同的深层链接。请参阅多个区域和语言示例。
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	日期或日期时间	建议 - ExclusiveEvent 要求填写 - 实体出版的开始日期。 PublicationEvent 表示实体首次发行的日期，例如电影首次上映的日期。 对于 ExclusiveEvent 和 FeaturedEvent，这代表实体开始独占或精选展示的开始日期。
releasedEvent.endDate	日期或日期时间	推荐 - 对于 ExclusiveEvent 为必需项 - 这仅适用于 ExclusiveEvent 和 FeaturedEvent 类型。 对于 ExclusiveEvent，这代表内容权利到期的日期。 对于 FeaturedEvent，这是指提供商永久性展示相应实体的最后日期。 如果内容永久保留或显示为精选内容，请将 endDate 设为自当前日期起的 20 年后。
releasedEvent.publishedBy	组织或个人	可选 - 发布此实体的组织或个人。
description	文本	强烈建议原因剧集的剧情简介。情节摘要比事实摘要更受欢迎。字符数限制为 300 个。 使用数组标记多种语言的说明。请参阅多语言表示法示例。
genre	文本	包含所有相关类型且按顺序排列的列表。例如：["Action", "Fashion", "Environment", "Football"]
keywords	文本	用于描述此内容的关键字或标记。也可以使用一组关键字。例如，["feature, biography"] 可以是用来描述相应内容的关键字数组。
actor	Person、PerformingGroup 或 PerformanceRole	强烈建议原因剧集的演职人员数组。请参阅此处的建模指南。
director	人称	强烈建议原因剧集的导演。
producer	组织或个人	强烈建议原因剧季的制作人。
image	ImageObject	强烈建议用于 Google TV 的原因 - 与 TVEpisode 相关的各种图片。如需详细了解 image 中必须包含的必需属性，请参阅图片属性。
trailer.description	文本	预告片的说明。请参阅预告片示例。
trailer.inLanguage	文本	采用 BCP 47 格式的预告片的语言。
trailer.url	网址	由各个制作工作室或授权来源公开上传并上传的预告片的网址。
trailer.regionsAllowed	Place	允许播放媒体的区域。如果未指定，系统会假定在每个地方都允许此操作。以 ISO 3166 格式指定国家/地区。
review	Review	查看电视剧集的评分
review.reviewRating	评分	如果提供了 review，则必须提供此属性：用于指定评价中提供的评分。
contentRating	文字或评分	需要成人内容，否则强烈建议 - 总体内容分级。如果内容分级是以文本字符串的形式提供的，则会接受两种变体： 分级机构在分级前面附加了空白字符。例如，美国的代理机构“TVPG”所给出的“TV-MA”分级应描述为“TVPG TV-MA”。请参阅代理机构列表。 值“分级未知”（不区分大小写），表示您不知道该内容的分级。
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	热门程度得分规范	强烈建议原因Google 根据这一得分及其他一些信号来确定为用户播放哪种媒体内容。此得分表示内容相对于您目录中其他内容的受欢迎程度；因此，该得分在各 Feed 之间在目录中的所有实体中必须保持一致。默认情况下，实体的热门程度分数设为 0。
popularityScore.@type	文本	始终设置为 PopularityScoreSpecification。
popularityScore.value	编号	非负数值，表示实体的热门程度；分数越高，表示热门程度越高。
popularityScore.eligibleRegion	国家/地区	此热门程度得分适用的地区。如果热门程度得分是全球适用的，则设为 EARTH。默认情况下，此属性会设置为 EARTH。 Note: 针对特定语言区域的热门程度高于全球 (EARTH) 热门程度

电视剧季

属性	预期类型	说明
@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	电视连续剧	必填 - 本季所属的电视连续剧。
partOfSeries.@type	文本	必需 - 始终设置为 TVSeries。
partOfSeries.@id	网址	必需 - 本季所属的 TVSeries 的 @id。
partOfSeries.name	文本	必需 - 电视连续剧的名称。
partOfSeries.sameAs	文本	可标识节目的参考网页的网址，例如节目的维基百科页面。此属性必须与 url 属性不同。
potentialAction	WatchAction	必需（如果适用） - 操作标记对象，用于提供操作的详细信息。 如果内容是视频点播 (VoD) 内容，则必须提供此属性；操作标记对象需要提供该内容的深层链接。 如果相应内容可通过 LiveTV 频道观看，则此属性为可选属性；关联的 BroadcastService 实体提供频道的深层链接。 TVSeason 可在 VoD 和 LiveTV 中使用。 使用数组可在多个区域指定不同的深层链接。请参阅多个区域和语言示例。
sameAs	网址	强烈建议原因指向标识剧季的参考网页的网址，例如剧季的维基百科页面。此属性必须与 url 属性不同。
releasedEvent	PublicationEvent、FeaturedEvent 或 ExclusiveEvent	强烈建议原因- PublicationEvent 用于指定出版商的原始内容（全球或本地）发布，例如电影的原创影院上映日期。 此外，FeaturedEvent 还表示您的服务以原始、精选、特殊等方式宣传这些内容。 ExclusiveEvent 指定您的服务在哪些国家/地区拥有独家发行权，并包括具体发布位置和时间。 如需了解详情及示例，请参阅示例部分。
releasedEvent.@type	文本	必需 - 请务必始终将此属性设置为以下其中一项： PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	国家/地区	必需属性 - 与此活动相关的地区。 对于“PublicationEvent”，这是发布内容的区域。 对于“FeaturedEvent”和“ExclusiveEvent”，这是精选或独家发布内容的区域。 对于各个国家/地区，请使用 ISO 3166 代码。若要指明世界上的每一个位置，请将此项设置为 EARTH。
releasedEvent.startDate	日期或日期时间	建议 - ExclusiveEvent 要求填写 - 实体出版的开始日期。 PublicationEvent 表示实体首次发行的日期，例如电影首次上映的日期。 对于 ExclusiveEvent 和 FeaturedEvent，这代表实体开始独占或精选展示的开始日期。
releasedEvent.endDate	日期或日期时间	推荐 - 对于 ExclusiveEvent 为必需项 - 这仅适用于 ExclusiveEvent 和 FeaturedEvent 类型。 对于 ExclusiveEvent，这代表内容权利到期的日期。 对于 FeaturedEvent，这是指提供商永久性展示相应实体的最后日期。 如果内容永久保留或显示为精选内容，请将 endDate 设为自当前日期起的 20 年后。
releasedEvent.publishedBy	组织或个人	可选 - 发布此实体的组织或个人。
description	文本	强烈建议原因剧季简介。情节摘要比事实摘要更受欢迎。字符数限制为 300 个。 使用数组标记多种语言的说明。请参阅多语言表示法示例。
actor	[人员、表演组或PerformanceRole	强烈建议原因电视剧季的演职人员数组。请参阅此处的建模指南。
director	人称	强烈建议原因节目的导演数组。
producer	组织或个人	强烈建议原因剧季的制作人。
image	ImageObject	与 TVSeason 相关的图片。如需详细了解 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	热门程度得分规范	强烈建议原因Google 根据这一得分及其他一些信号来确定为用户播放哪种媒体内容。此得分表示内容相对于您目录中其他内容的受欢迎程度；因此，该得分在各 Feed 之间在目录中的所有实体中必须保持一致。默认情况下，实体的热门程度分数设为 0。
popularityScore.@type	文本	始终设置为 PopularityScoreSpecification。
popularityScore.value	编号	非负数值，表示实体的热门程度；分数越高，表示热门程度越高。
popularityScore.eligibleRegion	国家/地区	此热门程度得分适用的地区。如果热门程度得分是全球适用的，则设为 EARTH。默认情况下，此属性会设置为 EARTH。 Note: 针对特定语言区域的热门程度高于全球 (EARTH) 热门程度
review	Review	查看电视剧季的评分
review.reviewRating	评分	如果提供了 review，则必须提供此属性：用于指定评价中提供的评分。
contentRating	文字或评分	需要成人内容，否则强烈建议 - 总体内容分级。如果内容分级是以文本字符串的形式提供的，则会接受两种变体： 分级机构在分级前面附加了空白字符。例如，美国的代理机构“TVPG”所给出的“TV-MA”分级应描述为“TVPG TV-MA”。请参阅代理机构列表。 值“分级未知”（不区分大小写），表示您不知道该内容的分级。
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 类型

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

属性	预期类型	说明
@type	Person 或 PerformingGroup	必需 - 始终设置为人员或表演组
@id	网址	强烈建议原因- 以 URI 格式显示的执行者或执行组标识符；例如 https://example.com/actor/abc。@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	必需 - 始终设置为人员或表演组
actor.@id	网址	强烈建议原因- URI 格式的执行者或执行组标识符；例如 https://example.com/actor/abc。@id必须满足以下要求： 在全球范围内，每个执行者/执行者群组在您的目录中都具有唯一性 该 ID 应保持稳定，不应随着时间的推移而发生变化。系统会将此字符串视为不透明字符串，且不一定是有效链接。 采用统一资源标识符 (URI) 的形式 贵组织必须对用于 @id 值的域名拥有所有权。 请注意，actor 属性中使用的 @id 在整个 Feed 中保持一致。例如，如果两部电影拥有同一演员，则这两个演员对象应保持一致的 @id 值。
actor.name	文本	必需 - 演员/演员/演员组的名称。
actor.sameAs	网址	强烈建议原因- 指向执行者或表演者的参照网页的网址；例如执行者的维基百科页面。它必须与 actor.@id 属性不同。

可接受的角色名称

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

roleName 值	说明
“Cameo”	客串角色（也称为客串角色）是著名人物在表演艺术作品中的短暂呈现。
“VoiceActor”	旁白表演是指在其中使用演员的语音，但演员出镜时不显示语音。这种情况最常出现在动画中，但当某个演员的声音配比另一演员的配音时也是如此。
“双精度”	双人角色会代替其他演员，使他的面孔不会显示。
“MotionCaptureActor”	MotionCaptureActor 是指录制人体动作的人，并根据这些信息为 2D 或 3D 计算机动画中的数字角色模型添加动画效果。

Person 和 PerformingGroup 类型通常接受这些值。

roleName 值	说明
“执行者”	演员是指在剧院的传统媒介或现代媒体（例如电影、电台和电视）上表演角色的人。
“GuestStar”	“嘉宾明星扮演虚构角色，参加过一集或几集的演出。在某些情况下，客串明星可能会扮演重要的周期性角色，而且可能会在连续剧中多次出现，尽管不是主要演员。如果演员表的客串演出或节目中有嘉宾，则将值设置为“GuestStar”。客串明星应该仅在剧集级别提供，不应在 TVSeries 级别添加。
“Guest”	“脱口秀嘉宾。请注意，虽然“GuestStar”是虚构角色，但“Guest”是非虚构的。
“解说员”	播送员是为节目提供开场和结束语的人物，介绍主办者、参赛者和/或名人嘉宾，描述可用的奖品，并在观众轻按间进行预热，并在休息间隙让他们娱乐。
“评论者”	评论者会在直播期间提供游戏或活动的实时评论。
“印象派”	印象派或模仿者是指表演者包括模仿名人和卡通人物的声音、声音和风度的行为。
“主机”	介绍、演示或主持电视节目的人，通常充当节目和观众的调解者。“主持人”通常是一个非虚构角色。
“CoHost”	与其他人共同举办活动/计划的人。
“GuestHost”	邀请对象是主持人，通常是脱口秀节目的主持人，即使常规节目不可用，也可以由节目来代替常规主持人。
“新闻播主”	通过电视新闻节目向当地、国内和国际用户呈现新闻和活动信息/告知公众的人物。
“记者”	记者或现场记者通常是某杂志的记者或记者，或者是向报纸、广播/电视新闻或其他类型公司提供报复的人员（来自遥远的、通常处于遥远的位置）。
“ShowJudge”	评委是指通常被认定为节目领域专家的人，具有“评委”的身份，用于评判面试官并参加电视连续剧竞赛的评委。
“样本组成员”	电台或电视面板的讨论或顾问小组的成员。
“参赛者”	参加比赛或游戏节目的参赛者是指参与比赛的人。
“StoryNarrator”	旁白是指讲述故事的人，尤其是讲述一篇小说或叙事诗歌的角色
“音乐人”	“音乐人可以是经常在观众面前表演的个人或团体，也可以是虚构人物，或者录制了音乐曲目或音乐专辑。只有某些音乐作品的演职员暗示其主要表演者才是演唱者和词作者时。此类型可用于将永久性音乐人或音乐人群组与嘉宾音乐人或音乐人群组关联起来。

区分主要角色和配角

为了区分电视节目中的主要/常规演员与客座/支持演员，请仅添加TVSeries实体中的主要演员，并且仅添加客串演员或具有TVEpisode角色的支持角色。确保主要/常规类型未添加到 TVEpisode 实体中。

示例

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

Actor 房源示例

执行者角色未知

当演员的角色未知时，建议仅使用 人物 或 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"
      }
  }
]

部分演员的已知角色

当未知角色角色元数据时，建议使用 Person 或 PerformingGroup 类型提供演员信息。对于已知此信息的其他情况，请使用 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、网址和名称
• 识别电视连续剧、电视剧季和电视剧集之间的关系
• 收集内容的元数据