电视节目的内容标记属性

本部分详细介绍了 TVSeriesTVEpisodeTVSeason 实体类型的内容标记属性。

提供 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 PublicationEventFeaturedEventExclusiveEvent 强烈推荐为什么?- PublicationEvent 用于指定发行商对内容的原始(全球或本地)发行,例如电影的原始影院上映日期。

此外,您可以使用 FeaturedEvent 指明您的服务以原创、精选、特别等形式推广此内容。

ExclusiveEvent 指定您的服务拥有独家发行权,并指明您的发行地点和时间。

有关详细信息和示例,请参阅示例部分
releasedEvent.@type 文本 必需属性 - 请务必将此属性始终设置为下列值之一:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 国家/地区 必需 - 与此事件相关的地区。

对于 PublicationEvent,这是指内容发布所在的地区。

对于 FeaturedEventExclusiveEvent,这是指内容被纳入精选或专享的地区。

对于国家/地区,请使用 ISO 3166 代码。如需指示世界上的任何地方,请设置为 EARTH
releasedEvent.startDate DateDateTime 建议 - 对于 ExclusiveEvent 为必需 - 实体的出版开始日期。

对于 PublicationEvent,此字段表示此实体的首次发布日期,例如电影在影院首次上映的日期。

对于 ExclusiveEventFeaturedEvent,此字段表示实体的独家或精选内容的开始日期。
releasedEvent.endDate DateDateTime 建议 - 对于 ExclusiveEvent 是必需的 - 此字段仅适用于 ExclusiveEventFeaturedEvent 类型。

对于 ExclusiveEvent,此字段表示内容权利到期的日期。

对于 FeaturedEvent,此字段代表提供方最近一次推介该实体的日期。

如果内容是永久独家内容或精选内容,请将 endDate 设置为从当前日期起 20 年后的日期。
releasedEvent.publishedBy OrganizationPerson 可选 - 发布此实体的组织或个人。
description 文本 强烈推荐为什么?节目的剧情简介。比起事实总结,最好采用剧情大纲。最多 300 个字符。
actor PersonPerformingGroupPerformanceRole 强烈推荐为什么?电视剧的演职人员的数组。请点击此处,查看建模指南。
director Person 强烈推荐为什么?节目的导演。
producer OrganizationPerson 强烈推荐为什么?节目的制作人。
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.@idpartOfSeason.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 PublicationEventFeaturedEventExclusiveEvent 强烈推荐为什么?- PublicationEvent 用于指定发行商对内容的原始(全球或本地)发行,例如电影的原始影院上映日期。

此外,您可以使用 FeaturedEvent 指明您的服务以原创、精选、特别等形式推广此内容。

ExclusiveEvent 指定您的服务拥有独家发行权,并指明您的发行地点和时间。

有关详细信息和示例,请参阅示例部分
releasedEvent.@type 文本 必需属性 - 请务必将此属性始终设置为下列值之一:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 国家/地区 必需 - 与此事件相关的地区。

对于 PublicationEvent,这是指内容发布所在的地区。

对于 FeaturedEventExclusiveEvent,这是指内容被纳入精选或专享的地区。

对于国家/地区,请使用 ISO 3166 代码。如需指示世界上的任何地方,请设置为 EARTH
releasedEvent.startDate DateDateTime 建议 - 对于 ExclusiveEvent 为必需 - 实体的出版开始日期。

对于 PublicationEvent,此字段表示此实体的首次发布日期,例如电影在影院首次上映的日期。

对于 ExclusiveEventFeaturedEvent,此字段表示实体的独家或精选内容的开始日期。
releasedEvent.endDate DateDateTime 建议 - 对于 ExclusiveEvent 是必需的 - 此字段仅适用于 ExclusiveEventFeaturedEvent 类型。

对于 ExclusiveEvent,此字段表示内容权利到期的日期。

对于 FeaturedEvent,此字段代表提供方最近一次推介该实体的日期。

如果内容是永久独家内容或精选内容,请将 endDate 设置为从当前日期起 20 年后的日期。
releasedEvent.publishedBy OrganizationPerson 可选 - 发布此实体的组织或个人。
description 文本 强烈推荐为什么?剧集的剧情简介。比起事实总结,最好采用剧情大纲。最多 300 个字符。
genre 文本 所有相关类型的有序列表。例如:["Action", "Fashion", "Environment", "Football"]
keywords 文本 用于描述此内容的关键字或标签。您还可以使用一系列关键字。例如,["feature, biography"] 可以是描述内容的关键字数组。
actor PersonPerformingGroupPerformanceRole 强烈推荐为什么?剧集的演职人员的数组。请点击此处,查看建模指南。
director Person 强烈推荐为什么?剧集的导演。
producer OrganizationPerson 强烈推荐为什么?剧季的制作人。
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 PublicationEventFeaturedEventExclusiveEvent 强烈推荐为什么?- PublicationEvent 用于指定发布商内容的原始(全球或本地)发行,例如电影的原始影院上映日期。

此外,您可以使用 FeaturedEvent 指明您的服务以原创、精选、特别等形式推广此内容。

ExclusiveEvent 指定您的服务拥有独家发行权,并指明您的发行地点和时间。

有关详细信息和示例,请参阅示例部分
releasedEvent.@type 文本 必需属性 - 请务必将此属性始终设置为下列值之一:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 国家/地区 必需 - 与此事件相关的地区。

对于 PublicationEvent,这是指内容发布所在的地区。

对于 FeaturedEventExclusiveEvent,这是指内容被纳入精选或专享的地区。

对于国家/地区,请使用 ISO 3166 代码。如需指示世界上的任何地方,请设置为 EARTH
releasedEvent.startDate DateDateTime 建议 - 对于 ExclusiveEvent 为必需 - 实体的出版开始日期。

对于 PublicationEvent,此字段表示此实体的首次发布日期,例如电影在影院首次上映的日期。

对于 ExclusiveEventFeaturedEvent,此字段表示实体的独家或精选内容的开始日期。
releasedEvent.endDate DateDateTime 建议 - 对于 ExclusiveEvent 是必需的 - 此字段仅适用于 ExclusiveEventFeaturedEvent 类型。

对于 ExclusiveEvent,此字段表示内容权利到期的日期。

对于 FeaturedEvent,此字段代表提供方最近一次推介该实体的日期。

如果内容是永久独家内容或精选内容,请将 endDate 设置为从当前日期起 20 年后的日期。
releasedEvent.publishedBy OrganizationPerson 可选 - 发布此实体的组织或个人。
description 文本 强烈推荐为什么?本季剧情简介。比起事实总结,最好采用剧情大纲。最多 300 个字符。
actor [PersonPerformingGroupPerformanceRole 强烈推荐为什么?剧季演员的数组。请点击此处,查看建模指南。
director Person 强烈推荐为什么?节目导演的数组。
producer OrganizationPerson 强烈推荐为什么?剧季的制作人。
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 = 暴力。

执行者规范

借助 TVSeriesTVEpisodeTVSeason 实体类型中的 actor 属性,您可以指定有关演员的更多详细信息,包括角色名称及其在电视节目中扮演的角色。以下部分介绍了上述做法,并提供了几个示例来说明其用法。

属性 预期类型 说明
actor PersonPerformingGroupPerformanceRole 强烈推荐为什么?:一系列投射成员。
  • 如果所扮演的角色知道,请使用类型 PerformanceRole。此外,您还可以视需要选择演职人员的角色名称。在这种情况下,演员 PersonPerformingGroup 嵌入到 PerformanceRole 对象中。
  • 当演职人员扮演的角色未知时,可以使用 Person 类型表示个别演员,或使用 PerformingGroup 提供表演团体/乐队的详细信息。

使用数组表示多个 Person、PerformingGroups 或 PerformanceRoles。

使用 PersonPerformingGroup 类型

使用 PersonPerformingGroup 类型时提供以下属性

属性 预期类型 说明
@type PersonPerformingGroup 必需 - 始终设置为 PersonPerformingGroup
@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 PersonPerformingGroup 必填 -
  • 使用数据类型 Person 时内容的类型转换成员。
  • 使用 PerformingGroup 数据类型时,内容的执行组/频段。
actor.@type PersonPerformingGroup 必需 - 始终设置为 PersonPerformingGroup
actor.@id 网址 强烈推荐为什么?- 演员或表演团体的标识符(采用 URI 格式);例如:https://example.com/actor/abc。@id必须满足以下要求:
  • 每个演员/表演群组在目录中具有全局唯一性
  • ID 应保持稳定,不应随着时间的推移而发生变化。它将被视为不透明字符串,且不必是有效链接。
  • 采用统一资源标识符 (URI) 的形式
  • 用于 @id 值的网域必须归贵组织所有。

请注意,actor 属性中使用的 @id 在整个 Feed 中应保持一致。例如,如果两部电影有同一位演员,则这两个演员对象的 @id 值应保持不变。

actor.name 文本 必需 - 演员/演员/演职人员/表演组的名称。
actor.sameAs 网址 强烈推荐为什么?- 指向参考网页的 网址,可标识演员或表演组;例如,演员的维基百科网页。此属性必须与 actor.@id 属性不同。

可接受的角色名称

这些值要求 actor.@typePerson

roleName 说明
“影城” 客串角色,也称为“客串”,是表演艺术中知名人物的简短形象。
“VoiceActor” 语音表演是指使用演员的声音,但该演员并未出现在画面中的声音。这种情况最常见于动画中,但也会出现某位演员的配音以其他演员的说话内容为配音的情况。
“双精度” 替身是指以不露脸的方式代替另一演员的人。
“MotionCaptureActor” MotionCaptureActor 是指记录真人演员动作,并使用该信息以 2D 或 3D 计算机动画形式为数字角色模型添加动画效果的人。

PersonPerformingGroup 类型通常可以使用这些值。

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

区分演员角色(主角和配角)

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

示例

TVSeriesTVEpisodeTVSeason 示例

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

您可以访问以下页面,了解与这些属性相关的主题: