本部分详细介绍了 TVSeries
、TVEpisode
和 TVSeason
实体类型的内容标记属性。
提供 TVSeason
作为完整实体是可选的。如需了解详情,请参阅 TVSeries、TVSeason 和 TVEpisode 关系部分。
规范表
电视连续剧
属性 | 预期类型 | 说明 |
---|---|---|
@context |
文本 | 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
|
@type |
文本 | 必需 - 始终设置为 TVSeries 。 |
@id |
网址 | 必需 - 内容的标识符,采用 URI 格式;例如 https://example.com/1234abc。@id 必须满足以下要求:
url 满足标识符的所有要求,因此我们建议您将实体的 url 用作 @id 。如需了解详情,请参阅标识符部分。 |
url |
网址 | 必需 - 内容的规范网址,Google 会使用该网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。url 必须满足以下要求:
urlTemplate 属性。 |
name |
文本 | 必需 - 节目的名称。
|
titleEIDR |
文本 | 强烈建议原因- EIDR(娱乐标识符注册)标识符,代表最一般/抽象级别的电影或电视作品。 例如,电视剧《权利的游戏》的标题为“EIDR”为“10.5240/C1B5-3BA1-8991-A571-8472-W”。 |
potentialAction |
WatchAction | 必需(如果适用) - 操作标记对象,用于提供操作的详细信息。
|
sameAs |
网址 | 强烈建议原因可标识节目的参考网页的网址,例如节目的维基百科页面。此属性必须与 url 属性不同。 |
inLanguage |
文本 | 该系列的原始语言(采用 BCP 47 格式)。 |
genre |
文本 | 包含所有相关类型且按顺序排列的列表。例如:["Action", "Fashion", "Environment", "Football"] |
keywords |
文本 | 用于描述此内容的关键字或标记。也可以使用一组关键字。例如,["feature, biography"] 可以是用来描述相应内容的关键字数组。 |
releasedEvent |
PublicationEvent 、FeaturedEvent 或 ExclusiveEvent |
强烈建议原因- PublicationEvent 用于指定出版商的原始内容(全球或本地)发布,例如电影的原创影院上映日期。此外, FeaturedEvent 还表示您的服务以原始、精选、特殊等方式宣传这些内容。ExclusiveEvent 指定您的服务在哪些国家/地区拥有独家发行权,并包括具体位置和时间。如需了解详情及示例,请参阅示例部分。 |
releasedEvent.@type |
文本 | 必需 - 请务必始终将此属性设置为以下其中一项:
|
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 |
文字或评分 | 需要成人内容,否则强烈建议 - 总体内容分级。如果内容分级是以文本字符串的形式提供的,则会接受两种变体:
|
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"}]
|
@type |
文本 | 必需 - 始终设置为 TVEpisode 。 |
@id |
网址 | 必需 - 内容的标识符,采用 URI 格式;例如 https://example.com/1234abc。@id 必须满足以下要求:
url 满足标识符的所有要求,因此我们建议您将实体的 url 用作 @id 。如需了解详情,请参阅标识符部分。 |
url |
网址 | 必需 - 内容的规范网址,Google 会使用该网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。url 必须满足以下要求:
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 属性。临时解决方法如下:
|
partOfSeason.@type |
文本 | 必需 - 始终设置为 TVSeason 。 |
partOfSeason.@id |
网址 | 必需 - 此分集所属的 TVSeason 的 @id 。 |
partOfSeason.seasonNumber |
整数 | 必填 - 表示此电视剧季排名的数字,按电视剧季中的剧季顺序排序。 |
partOfSeries |
电视连续剧 | 必需 - 此剧集所属的电视连续剧。 |
partOfSeries.@type |
文本 | 必需 - 始终设置为 TVSeries 。 |
partOfSeries.@id |
网址 | 必需 - 此分集所属的 TVSeries 的 @id 。 |
partOfSeries.name |
文本 | 必需 - 电视连续剧的名称。 |
partOfSeries.sameAs |
文本 | 可标识节目的参考网页的网址,例如节目的维基百科页面。此属性必须与 url 属性不同。 |
potentialAction |
WatchAction | 必需(如果适用) - 操作标记对象,用于提供操作的详细信息。
|
sameAs |
强烈建议原因网址 | 可标识剧集的参考网页的网址,用于测试剧集的维基百科页面。此属性必须与 url 属性不同。 |
duration |
时长 | 分集的运行时(采用 ISO 8601 格式)。请使用以下格式:“PT00H00M”。 |
releasedEvent |
PublicationEvent 、FeaturedEvent 或 ExclusiveEvent |
强烈建议原因- PublicationEvent 用于指定出版商的原始内容(全球或本地)发布,例如电影的原创影院上映日期。此外, FeaturedEvent 还表示您的服务以原始、精选、特殊等方式宣传这些内容。ExclusiveEvent 指定您的服务在哪些国家/地区拥有独家发行权,并包括具体位置和时间。如需了解详情及示例,请参阅示例部分。 |
releasedEvent.@type |
文本 | 必需 - 请务必始终将此属性设置为以下其中一项:
|
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 |
文字或评分 | 需要成人内容,否则强烈建议 - 总体内容分级。如果内容分级是以文本字符串的形式提供的,则会接受两种变体:
|
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"}]
|
@type |
文本 | 必需 - 始终设置为 TVSeason 。 |
@id |
网址 | 必需 - 内容的标识符,采用 URI 格式;例如 https://example.com/1234abc。@id 必须满足以下要求:
url 满足标识符的所有要求,因此我们建议您将实体的 url 用作 @id 。如需了解详情,请参阅标识符部分。 |
url |
网址 | 必需 - 内容的规范网址,Google 会使用该网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。url 必须满足以下要求:
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 | 必需(如果适用) - 操作标记对象,用于提供操作的详细信息。
|
sameAs |
网址 | 强烈建议原因指向标识剧季的参考网页的网址,例如剧季的维基百科页面。此属性必须与 url 属性不同。 |
releasedEvent |
PublicationEvent 、FeaturedEvent 或 ExclusiveEvent |
强烈建议原因- PublicationEvent 用于指定出版商的原始内容(全球或本地)发布,例如电影的原创影院上映日期。此外, FeaturedEvent 还表示您的服务以原始、精选、特殊等方式宣传这些内容。ExclusiveEvent 指定您的服务在哪些国家/地区拥有独家发行权,并包括具体发布位置和时间。如需了解详情及示例,请参阅示例部分。 |
releasedEvent.@type |
文本 | 必需 - 请务必始终将此属性设置为以下其中一项:
|
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 |
文字或评分 | 需要成人内容,否则强烈建议 - 总体内容分级。如果内容分级是以文本字符串的形式提供的,则会接受两种变体:
|
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 | 强烈建议原因:转换成员的数组。
使用数组来表示多个人物、表演组或性能角色。 |
使用 Person
或 PerformingGroup
类型
使用 Person 或 PerformingGroup 类型时,请提供以下属性
属性 | 预期类型 | 说明 |
---|---|---|
@type |
Person 或 PerformingGroup | 必需 - 始终设置为人员或表演组 |
@id |
网址 | 强烈建议原因- 以 URI 格式显示的执行者或执行组标识符;例如 https://example.com/actor/abc。@id 必须满足以下要求:
请注意,actor 属性中使用的 |
name |
文本 | 必需 - 演员/演员/演员组的名称。 |
sameAs |
网址 | 强烈建议原因- 指向执行者或表演者的参照网页的网址;例如执行者的维基百科页面。此属性必须与 @id 属性不同。 |
使用 PerformanceRole
类型
使用 PerformanceRole 类型时,请提供以下属性
属性 | 预期类型 | 说明 |
---|---|---|
@type |
PerformanceRole | 必需属性 - 始终设置为 PerformanceRole |
roleName |
文本 | 强烈建议原因- 演职人员扮演、表演或履行的角色。请点击此处查看可接受的值列表。 |
characterName |
文本 | 扮演某些演员或演员的角色。如果执行者类型为 PerformingGroup,请勿设置此字段。 |
actor |
Person 或 PerformingGroup | 必填 -
|
actor.@type |
Person 或 PerformingGroup | 必需 - 始终设置为人员或表演组 |
actor.@id |
网址 | 强烈建议原因- URI 格式的执行者或执行组标识符;例如 https://example.com/actor/abc。@id 必须满足以下要求:
请注意,actor 属性中使用的 |
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"
}
]
相关页面
请查看以下页面,了解与这些属性相关的主题: