电视节目的内容标记属性

本部分详细介绍了 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 可抓取的有效规范网址。 。如需了解播放的深层链接，请改为参阅 target 对象的 urlTemplate 属性。
name	文本	必需 - 节目的名称。 可以使用数组列出不同语言的名称。请参阅多区域和多种语言示例。 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
titleEIDR	文本	强烈推荐为什么？- EIDR（娱乐标识符注册）标识符，最一般/抽象级别表示电影或电视作品。 例如，名为“Game of Thrones”的电视连续剧的 titleEIDR为“10.5240/C1B5-3BA1-8991-A571-8472-W”。
potentialAction	WatchAction	必需（如果适用）- 一个操作标记对象，用于提供操作的详细信息。 如果内容可通过视频点播 (VoD) 播放，则该属性为必需属性；操作标记对象需要提供内容的深层链接。 如果内容在 LiveTV 频道播出，则此属性为可选属性；而关联的 BroadcastService 实体则提供频道的深层链接。 VoD 和 LiveTV 均支持 TVSeries。 您可以使用数组在多个区域中指定不同的深层链接。请参阅多区域和多种语言示例。
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	Organization 或 Person	可选 - 发布此实体的组织或个人。
description	文本	强烈推荐为什么？节目的剧情简介。比起事实总结，最好采用剧情大纲。最多 300 个字符。 使用数组标记多种语言的说明。请参阅多区域和多种语言示例。
actor	Person、PerformingGroup 或 PerformanceRole	强烈推荐为什么？电视剧的演职人员的数组。请点击此处，查看建模指南。
director	Person	强烈推荐为什么？节目的导演。
producer	Organization 或 Person	强烈推荐为什么？节目的制作人。
image	ImageObject	Google TV 必须提供 - 与 TVSeries 相关的图片。如需详细了解 image 中包含的必需属性和可选属性，请参阅图片属性。
trailer.description	文本	预告片的说明。请参阅 Trailer 示例。
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: 特定于语言区域的受欢迎程度优先于全球 (EARTH) 的热门程度
review	Review	查看电视连续剧的分级
review.reviewRating	评分	如果提供了 review，则为必需。此属性用于指定评价中的评分。
contentRating	文字或评分	必须为成人内容为必填，否则强烈建议提供 - 总体内容分级。如果内容分级以文本字符串的形式指定，可以接受以下两种形式： 分级机构在评分前面附加了一个空格。例如，“TV-MA”评分机构“TVPG”应称为“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 可抓取的有效规范网址。 。如需了解播放的深层链接，请改为参阅 target 对象的 urlTemplate 属性。
name	文本	必需 - 剧集的名称。 可以使用数组列出不同语言的名称。请参阅多种语言呈现示例。 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
titleEIDR	文本	强烈推荐为什么？- EIDR（娱乐标识符注册）标识符，最一般/抽象级别表示电影或电视作品。 例如，名为“Game of Thrones”的 TVSeries 第一季第一集的 titleEIDR为“10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”。
editEIDR	文本	强烈推荐为什么？- 代表电影或电视节目的特定剪辑版本 / 版本的 EIDR（娱乐标识符注册）标识符。 例如，名为“Game of Thrones”的电视连续剧第一季的第一集，其标题 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) 播放，则该属性为必需属性；操作标记对象需要提供内容的深层链接。 如果内容在 LiveTV 频道播出，则此属性为可选属性；而关联的 BroadcastService 实体则提供频道的深层链接。 VoD 和 LiveTV 均支持 TVEpisode。 您可以使用数组在多个区域中指定不同的深层链接。请参阅多区域和多种语言示例。
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	Organization 或 Person	可选 - 发布此实体的组织或个人。
description	文本	强烈推荐为什么？剧集的剧情简介。比起事实总结，最好采用剧情大纲。最多 300 个字符。 使用数组标记多种语言的说明。请参阅多种语言呈现示例。
genre	文本	所有相关类型的有序列表。例如：["Action", "Fashion", "Environment", "Football"]
keywords	文本	用于描述此内容的关键字或标签。您还可以使用一系列关键字。例如，["feature, biography"] 可以是描述内容的关键字数组。
actor	Person、PerformingGroup 或 PerformanceRole	强烈推荐为什么？剧集的演职人员的数组。请点击此处，查看建模指南。
director	Person	强烈推荐为什么？剧集的导演。
producer	Organization 或 Person	强烈推荐为什么？剧季的制作人。
image	ImageObject	针对 Google TV 极力推荐的原因 - 与电视剧集相关的各种图片。如需详细了解 image 中包含的必需属性和可选属性，请参阅图片属性。
trailer.description	文本	预告片的说明。请参阅 Trailer 示例。
trailer.inLanguage	文本	预告片的语言，采用 BCP 47 格式。
trailer.url	网址	由各制作工作室或授权来源公开托管并上传的预告片的网址。
trailer.regionsAllowed	Place	允许播放媒体内容的区域。如果未指定，系统会默认允许在所有国家/地区投放。以 ISO 3166 格式指定国家/地区。
review	Review	查看电视剧集的分级
review.reviewRating	评分	如果提供了 review，则为必需。此属性用于指定评价中的评分。
contentRating	文字或评分	必须为成人内容为必填，否则强烈建议提供 - 总体内容分级。如果内容分级以文本字符串的形式指定，可以接受以下两种形式： 分级机构在评分前面附加了一个空格。例如，“TV-MA”评分机构“TVPG”应称为“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: 特定于语言区域的受欢迎程度优先于全球 (EARTH) 的热门程度

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 可抓取的有效规范网址。 。如需了解播放的深层链接，请改为参阅 target 对象的 urlTemplate 属性。
name	文本	必需属性 - 相应电视剧季的名称。 可以使用数组列出不同语言的名称。请参阅多种语言呈现示例。 请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
titleEIDR	文本	强烈推荐为什么？- EIDR（娱乐标识符注册）标识符，最一般/抽象级别表示电影或电视作品。 例如，名为“Game of Thrones”的电视连续剧第一季的 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) 播放，则必须提供此属性；操作标记对象需要提供内容的深层链接。 如果内容在 LiveTV 频道播出，则此属性为可选属性；而关联的 BroadcastService 实体则提供频道的深层链接。 VoD 和 LiveTV 均支持 TVSeason。 您可以使用数组在多个区域中指定不同的深层链接。请参阅多区域和多种语言示例。
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	Organization 或 Person	可选 - 发布此实体的组织或个人。
description	文本	强烈推荐为什么？本季剧情简介。比起事实总结，最好采用剧情大纲。最多 300 个字符。 使用数组标记多种语言的说明。请参阅多种语言呈现示例。
actor	[Person、PerformingGroup 或 PerformanceRole	强烈推荐为什么？剧季演员的数组。请点击此处，查看建模指南。
director	Person	强烈推荐为什么？节目导演的数组。
producer	Organization 或 Person	强烈推荐为什么？剧季的制作人。
image	ImageObject	与电视季相关的图片。如需详细了解 image 中包含的必需属性和可选属性，请参阅图片属性。
genre	文本	所有相关类型的有序列表。例如：["Action", "Fashion", "Environment", "Football"]
keywords	文本	用于描述此内容的关键字或标签。您还可以使用一系列关键字。例如，["feature, biography"] 可以是描述内容的关键字数组。
trailer.description	文本	预告片的说明。请参阅 Trailer 示例。
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: 特定于语言区域的受欢迎程度优先于全球 (EARTH) 的热门程度
review	Review	查看电视剧季的评分
review.reviewRating	评分	如果提供了 review，则为必需。此属性用于指定评价中的评分。
contentRating	文字或评分	必须为成人内容为必填，否则强烈建议提供 - 总体内容分级。如果内容分级以文本字符串的形式指定，可以接受以下两种形式： 分级机构在评分前面附加了一个空格。例如，“TV-MA”评分机构“TVPG”应称为“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、PerformingGroups 或 PerformanceRoles。

使用 Person 或 PerformingGroup 类型

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

属性	预期类型	说明
@type	Person 或 PerformingGroup	必需 - 始终设置为 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	必需 - 始终设置为 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 值	说明
“影城”	客串角色，也称为“客串”，是表演艺术中知名人物的简短形象。
“VoiceActor”	语音表演是指使用演员的声音，但该演员并未出现在画面中的声音。这种情况最常见于动画中，但也会出现某位演员的配音以其他演员的说话内容为配音的情况。
“双精度”	替身是指以不露脸的方式代替另一演员的人。
“MotionCaptureActor”	MotionCaptureActor 是指记录真人演员动作，并使用该信息以 2D 或 3D 计算机动画形式为数字角色模型添加动画效果的人。

Person 和 PerformingGroup 类型通常可以使用这些值。

roleName 值	说明
“执行者”	演员是指在传统剧院媒介或电影、广播和电视等现代媒体中塑造角色的人。
“GuestStar”	“客串明星是指扮演虚构角色，只在一集或几集中出现的演员。在某些情况下，客串明星可能会扮演一个重要的反复出镜的角色，并且可能会在一个系列中多次出现，即使它并非主演。将值设置为“GuestStar”当演职人员有嘉宾表演或嘉宾出镜时。客串明星应仅在剧集级别提供，不应在 TVSeries 级别添加。
“Guest”	“一位脱口秀嘉宾。请注意，虽然使用“GuestStar”虚构角色“Guest”并非虚构的呈现。
“播报员”	播音员是为节目提供开场白和结束语、介绍主持人、参赛者和/或名人嘉宾、描述可以获得的奖品、在录制前为观众暖场以及在休息期间让观众保持愉悦心情的人员。
“解说员”	解说员通常在直播期间提供比赛或活动的实时评论。
“印象派”	印象派或模仿者是指模仿名人和卡通人物的声音、声音和举止的表演者。
“主机”	介绍、演示或主持电视节目的人员，通常担任节目和观众的调解者。“主持人”通常是非虚构的角色。
“共同托管”	与其他人一起主持活动/节目的人。
“GuestHost”	嘉宾主持人通常是脱口秀的主持人，在没有常客时代替常规主持人来主持节目。
“Newscaster”	通过电视新闻节目向公众展示/通知公众，当地、全国和国际范围内发生的新闻和活动。
“记者”	记者或现场记者通常是杂志的记者或评论员，或者是来自偏远且通常较远的地方，为报纸、广播或电视新闻提供报道的经纪人，或其他类型的公司。
“ShowJudge”	评委通常被认为是节目领域的专家，被赋予“评委”角色对参加电视连续剧试镜和参加比赛的参赛者进行批评。
“小组成员”	广播或电视委员会讨论或顾问委员会成员。
“参赛者”	比赛或游戏节目的参赛者是参与其中的人。
“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"
      }
  }
]

演员子集的已知角色

如果表演角色元数据未知，我们建议您使用 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、网址和名称
• 确定电视连续剧、电视季和电视剧集之间的关系
• 收集内容的元数据