电视节目的内容标记属性

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

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

规范表

TVSeries

属性	预期类型	说明
`@context`	文本	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文的 @language 都应设置为采用 BCP 47 格式的相应语言代码。例如，如果语言设置为西班牙语，即使字幕/配音语言为英语，名称也会被视为西班牙语。
`@type`	文本	必需 - 始终设置为 `TVSeries`。
`@id`	网址	必需 - 采用 URI 格式的内容标识符；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在您的目录中具有全局唯一性该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。以统一资源标识符 (URI) 的形式用于 @id 值的网域必须归您的组织所有。由于实体的 `url` 符合作为标识符的所有要求，因此我们建议您使用实体的 `url` 作为 `@id`。如需了解详情，请参阅标识符部分。
`url`	网址	必需 - 内容的规范网址，Google 会使用该网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。 `url` 必须满足以下要求： `url` 必须是全局唯一的 `url` 必须包含 Google 可以抓取的有效规范网址。如需了解播放的深层链接，请改为参阅目标对象的 `urlTemplate` 属性。
`name`	文本	必需 - 节目的名称。使用数组列出不同语言的名称。请参阅多个地区和语言示例。请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
`titleEIDR`	文本	强烈推荐为什么？- 一个 EIDR（娱乐业标识注册）标识符，用于在最一般/抽象的级别上表示影视作品。例如，电视连续剧《权力的游戏》的 titleEIDR 为“10.5240/C1B5-3BA1-8991-A571-8472-W”。
`potentialAction`	WatchAction	如果适用，则为必需属性 - 提供操作详细信息的操作标记对象。如果内容可通过视频点播 (VoD) 观看，则此属性为必需属性；Action 标记对象需要提供内容的深层链接。如果内容可在 LiveTV 频道上观看，则此属性为可选属性；关联的 `BroadcastService` 实体会提供频道的深层链接。 `TVSeries` 可在 VoD 和 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`	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 必需 - 与电视剧相关联的图片。如需详细了解 `image` 中要包含的必需属性和可选属性，请参阅图片属性。
`trailer.description`	文本	预告片的说明。请参阅预告片示例。
`trailer.inLanguage`	文本	强烈建议：预告片的语言，采用 BCP 47 格式。
`trailer.url`	网址	由相应制作工作室或授权来源公开托管和上传的预告片的网址。
`trailer.regionsAllowed`	Place	允许显示相应媒体的地区。如果未指定，则假定允许在所有地方显示。以 ISO 3166 格式指定国家/地区。
`identifier`	PropertyValue	强烈推荐为什么？- 明确标识了相应实体的外部 ID 或其他 ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。
`popularityScore`	PopularityScoreSpecification	强烈推荐为什么？Google 使用的一种分数，以及其他信号，用于确定要为用户播放哪些媒体内容。此得分表示内容相对于您目录中其他内容的受欢迎程度；因此，得分的比例需要在您的 Feed 中以及您目录中的所有实体之间保持一致。默认情况下，实体的热度得分设为 0。
`popularityScore.@type`	文本	一律设置为 `PopularityScoreSpecification`
`popularityScore.value`	编号	一个非负数值，用于表示实体的受欢迎程度；得分越高，表示受欢迎程度越高。
`popularityScore.eligibleRegion`	国家/地区	相应热度得分适用的一个或多个地区。如果热度得分适用于全球，请设置为 `EARTH`。默认情况下，此属性设置为 `EARTH`。 `Note:` 特定于语言区域的热度优先于全球（地球）热度
`review`	Review	查看电视剧的评分
`review.reviewRating`	评分	如果提供了 `review`，则必须使用此属性。此属性用于指定评价中给出的评分。
`contentRating`	Text 或 Rating	对于成人内容，此属性为必需属性；对于其他内容，强烈建议使用此属性 - 总体内容分级。如果内容分级以文本字符串的形式提供，则接受以下两种变体：评级机构，附加在评级前面，中间用空格隔开。例如，美国“TVPG”机构的“TV-MA”分级应描述为“TVPG TV-MA”。请参阅代理机构列表。值为“RATING NOT KNOWN”（不区分大小写），表示您不知道相应内容的评级。
`contentRating.author`	组织	如果 `contentRating` 使用 `Rating`，则为必需属性 - 分级机构的名称。如需查看接受的分级机构列表，请参阅内容分级机构页面
`contentRating.ratingValue`	文本	如果 `contentRating` 使用 `Rating`，则为必需属性 - 分级的值。
`contentRating.advisoryCode`	文本	相应内容的警示代码。可接受的值包括 D、FV、L、S 和 V。D = 对白，FV = 奇幻暴力，L = 粗俗语言，S = 色情内容，V = 暴力。

TVEpisode

属性	预期类型	说明
`@context`	文本	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文的 @language 都应设置为采用 BCP 47 格式的相应语言代码。例如，如果语言设置为西班牙语，即使字幕/配音语言为英语，名称也会被视为西班牙语。
`@type`	文本	必需 - 始终设置为 `TVEpisode`。
`@id`	网址	必需 - 采用 URI 格式的内容标识符；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在您的目录中具有全局唯一性该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。以统一资源标识符 (URI) 的形式用于 @id 值的网域必须归您的组织所有。由于实体的 `url` 符合作为标识符的所有要求，因此我们建议您使用实体的 `url` 作为 `@id`。如需了解详情，请参阅标识符部分。
`url`	网址	必需 - 内容的规范网址，Google 会使用该网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。 `url` 必须满足以下要求： `url` 必须是全局唯一的 `url` 必须包含 Google 可以抓取的有效规范网址。如需了解播放的深层链接，请改为参阅目标对象的 `urlTemplate` 属性。
`name`	文本	必需 - 分集的名称。使用数组列出不同语言的名称。请参阅多种语言表示法示例。请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
`titleEIDR`	文本	强烈推荐为什么？- 一个 EIDR（娱乐业标识注册）标识符，用于在最一般/抽象的级别上表示影视作品。例如，电视剧《权力的游戏》第一季第一集的 titleEIDR 为“10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”。
`editEIDR`	文本	强烈推荐为什么？- 一个 EIDR（娱乐业标识注册）标识符，用于表示影视作品的特定剪辑 / 版本。例如，电视连续剧《权力的游戏》第一季的第一集（其影视内容 EIDR 为“10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”）有一个剪辑版本，例如“10.5240/FB97-C847-2969-D0AB-ECD1-C”。提供 editEIDR 时， `titleEIDR` 属性是必需的。
`inLanguage`	文本	强烈建议：剧集的原始语言，采用 BCP 47 格式。
`episodeNumber`	整数	必需 - 用于指示相应剧集在剧季剧集顺序中的位置的编号。`episodeNumber` 需要在每个赛季开始时重新开始；也就是说，每个赛季的第一集需要为 1。
`partOfSeason`	TVSeason	必需属性 - 相应剧集所属的电视季。即使 `TVEpisode` 没有对应的 `TVSeason`，您仍需提供 `partOfSeason.@id` 和 `partOfSeason.seasonNumber` 属性。临时解决方法：获取 `partofSeries.@id`（例如 http://www.example.com/my_favorite_tv_show），并附加一个占位查询字段（例如 ?season1），以创建唯一的 `partOfSeason.@id`（例如 http://www.example.com/my_favorite_tv_show?season1）。将 `partOfSeason.seasonNumber` 设置为 1。
`partOfSeason.@type`	文本	必需 - 始终设置为 `TVSeason`。
`partOfSeason.@id`	网址	必需 - 相应剧集所属的 `TVSeason` 的 `@id`。
`partOfSeason.seasonNumber`	整数	必需 - 用于指示相应剧季在电视剧的剧季顺序中的位置的数字。
`partOfSeries`	TVSeries	必需 - 相应剧集所属的电视连续剧。
`partOfSeries.@type`	文本	必需 - 始终设置为 `TVSeries`。
`partOfSeries.@id`	网址	必需 - 相应剧集所属的 `TVSeries` 的 `@id`。
`partOfSeries.name`	文本	必需 - 电视连续剧的名称。
`partOfSeries.sameAs`	文本	可用于标识节目的参考网页的网址；例如，节目的维基百科网页。此值必须与 `url` 属性不同。
`potentialAction`	WatchAction	如果适用，则为必需属性 - 提供操作详细信息的操作标记对象。如果内容可通过视频点播 (VoD) 观看，则此属性为必需属性；Action 标记对象需要提供内容的深层链接。如果内容可在 LiveTV 频道上观看，则此属性为可选属性；关联的 `BroadcastService` 实体会提供频道的深层链接。 `TVEpisode` 可在视频点播和 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`	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 - 与 TVEpisode 相关的各种图片。如需详细了解 `image` 中要包含的必需属性和可选属性，请参阅图片属性。
`trailer.description`	文本	预告片的说明。请参阅预告片示例。
`trailer.inLanguage`	文本	强烈建议：预告片的语言，采用 BCP 47 格式。
`trailer.url`	网址	由相应制作工作室或授权来源公开托管和上传的预告片的网址。
`trailer.regionsAllowed`	Place	允许显示相应媒体的地区。如果未指定，则假定允许在所有地方显示。以 ISO 3166 格式指定国家/地区。
`review`	Review	查看电视节目的评分
`review.reviewRating`	评分	如果提供了 `review`，则必须使用此属性。此属性用于指定评价中给出的评分。
`contentRating`	Text 或 Rating	对于成人内容，此属性为必需属性；对于其他内容，强烈建议使用此属性 - 总体内容分级。如果内容分级以文本字符串的形式提供，则接受以下两种变体：评级机构，附加在评级前面，中间用空格隔开。例如，美国“TVPG”机构的“TV-MA”分级应描述为“TVPG TV-MA”。请参阅代理机构列表。值为“RATING NOT KNOWN”（不区分大小写），表示您不知道相应内容的评级。
`contentRating.author`	组织	如果 `contentRating` 使用 `Rating`，则为必需属性 - 分级机构的名称。如需查看接受的分级机构列表，请参阅内容分级机构页面
`contentRating.ratingValue`	文本	如果 `contentRating` 使用 `Rating`，则为必需属性 - 分级的值。
`contentRating.advisoryCode`	文本	相应内容的警示代码。可接受的值包括 D、FV、L、S 和 V。D = 对白，FV = 奇幻暴力，L = 粗俗语言，S = 色情内容，V = 暴力。
`identifier`	PropertyValue	强烈推荐为什么？- 明确标识了相应实体的外部 ID 或其他 ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。
`popularityScore`	PopularityScoreSpecification	强烈推荐为什么？Google 使用的一种分数，以及其他信号，用于确定要为用户播放哪些媒体。此得分表示内容相对于您目录中其他内容的受欢迎程度；因此，得分的比例需要在您的 Feed 中以及目录中的所有实体之间保持一致。默认情况下，实体的热度得分设为 0。
`popularityScore.@type`	文本	一律设置为 `PopularityScoreSpecification`
`popularityScore.value`	编号	一个非负数值，用于表示实体的受欢迎程度；得分越高，表示受欢迎程度越高。
`popularityScore.eligibleRegion`	国家/地区	相应热度得分适用的一个或多个地区。如果热度得分适用于全球，请设置为 `EARTH`。默认情况下，此属性设置为 `EARTH`。 `Note:` 特定于语言区域的热度优先于全球（地球）热度

TVSeason

属性	预期类型	说明
`@context`	文本	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文的 @language 都应设置为采用 BCP 47 格式的相应语言代码。例如，如果语言设置为西班牙语，即使字幕/配音语言为英语，名称也会被视为西班牙语。
`@type`	文本	必需 - 始终设置为 `TVSeason`。
`@id`	网址	必需 - 采用 URI 格式的内容标识符；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在您的目录中具有全局唯一性该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。以统一资源标识符 (URI) 的形式用于 @id 值的网域必须归您的组织所有。由于实体的 `url` 符合作为标识符的所有要求，因此我们建议您使用实体的 `url` 作为 `@id`。如需了解详情，请参阅标识符部分。
`url`	网址	必需 - 内容的规范网址，Google 会使用该网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。 `url` 必须满足以下要求： `url` 必须是全局唯一的 `url` 必须包含 Google 可以抓取的有效规范网址。如需了解播放的深层链接，请改为参阅目标对象的 `urlTemplate` 属性。
`name`	文本	必需 - 相应电视季的名称。使用数组列出不同语言的名称。请参阅多种语言表示法示例。请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
`titleEIDR`	文本	强烈推荐为什么？- 一个 EIDR（娱乐业标识注册）标识符，用于在最一般/抽象的级别上表示影视作品。例如，电视剧《权力的游戏》第一季的 titleEIDR 为“10.5240/FD91-C72C-4161-FCBA-058B-1”。
`seasonNumber`	整数	必需 - 用于指示相应剧季在电视剧的剧季顺序中的位置的数字。
`partOfSeries`	TVSeries	必需 - 相应剧季所属的电视连续剧。
`partOfSeries.@type`	文本	必需 - 始终设置为 `TVSeries`。
`partOfSeries.@id`	网址	必需 - 相应季所属的`TVSeries`的`@id`。
`partOfSeries.name`	文本	必需 - 电视连续剧的名称。
`partOfSeries.sameAs`	文本	可用于标识节目的参考网页的网址；例如，节目的维基百科网页。此值必须与 `url` 属性不同。
`potentialAction`	WatchAction	如果适用，则为必需属性 - 提供操作详细信息的操作标记对象。如果内容可通过视频点播 (VoD) 观看，则此属性为必需属性；Action 标记对象需要提供内容的深层链接。如果内容可在 LiveTV 频道上观看，则此属性为可选属性；关联的 `BroadcastService` 实体会提供频道的深层链接。 `TVSeason` 可在 VoD 和 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`	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.inLanguage`	文本	强烈建议：预告片的语言，采用 BCP 47 格式。
`trailer.url`	网址	由相应制作工作室或授权来源公开托管和上传的预告片的网址。
`trailer.regionsAllowed`	Place	允许显示相应媒体的地区。如果未指定，则假定允许在所有地方显示。以 ISO 3166 格式指定国家/地区。
`identifier`	PropertyValue	强烈推荐为什么？- 明确标识了相应实体的外部 ID 或其他 ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。
`popularityScore`	PopularityScoreSpecification	强烈推荐为什么？Google 使用的一种分数，以及其他信号，用于确定要为用户播放哪些媒体。此得分表示内容相对于您目录中其他内容的受欢迎程度；因此，得分的比例需要在您的 Feed 中以及目录中的所有实体之间保持一致。默认情况下，实体的热度得分设为 0。
`popularityScore.@type`	文本	一律设置为 `PopularityScoreSpecification`
`popularityScore.value`	编号	一个非负数值，用于表示实体的受欢迎程度；得分越高，表示受欢迎程度越高。
`popularityScore.eligibleRegion`	国家/地区	相应热度得分适用的一个或多个地区。如果热度得分适用于全球，请设置为 `EARTH`。默认情况下，此属性设置为 `EARTH`。 `Note:` 特定于语言区域的热度优先于全球（地球）热度
`review`	Review	查看电视季的评分
`review.reviewRating`	评分	如果提供了 `review`，则必须使用此属性。此属性用于指定评价中给出的评分。
`contentRating`	Text 或 Rating	对于成人内容，此属性为必需属性；对于其他内容，强烈建议使用此属性 - 总体内容分级。如果内容分级以文本字符串的形式提供，则接受以下两种变体：评级机构，附加在评级前面，中间用空格隔开。例如，美国“TVPG”机构的“TV-MA”分级应描述为“TVPG TV-MA”。请参阅代理机构列表。值为“RATING NOT KNOWN”（不区分大小写），表示您不知道相应内容的评级。
`contentRating.author`	组织	如果 `contentRating` 使用 `Rating`，则为必需属性 - 分级机构的名称。如需查看接受的分级机构列表，请参阅内容分级机构页面
`contentRating.ratingValue`	文本	如果 `contentRating` 使用 `Rating`，则为必需属性 - 分级的值。
`contentRating.advisoryCode`	文本	相应内容的警示代码。可接受的值包括 D、FV、L、S 和 V。D = 对白，FV = 奇幻暴力，L = 粗俗语言，S = 色情内容，V = 暴力。

执行者规范

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

属性预期类型说明

属性	预期类型	说明
`actor`	Person 或 PerformingGroup 或 PerformanceRole	强烈推荐为什么？：演员的数组。如果知道演员扮演的角色和（可选）角色名称，请使用 PerformanceRole 类型。在这种情况下，演员 Person 或 PerformingGroup 嵌入在 PerformanceRole 对象中。如果演员扮演的角色未知，请使用 Person 类型来指明个人演员，或使用 PerformingGroup 来提供表演团体/乐队的详细信息。使用数组来表示多个 Person、PerformingGroup 或 PerformanceRole。

actor

Person 或 PerformingGroup 或 PerformanceRole

强烈推荐为什么？：演员的数组。

如果知道演员扮演的角色和（可选）角色名称，请使用 PerformanceRole 类型。在这种情况下，演员 Person 或 PerformingGroup 嵌入在 PerformanceRole 对象中。
如果演员扮演的角色未知，请使用 Person 类型来指明个人演员，或使用 PerformingGroup 来提供表演团体/乐队的详细信息。

使用数组来表示多个 Person、PerformingGroup 或 PerformanceRole。

使用 `Person` 或 `PerformingGroup` 类型

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

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

使用 `PerformanceRole` 类型

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

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

可接受的角色名称

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

`roleName` 值	说明
“Cameo”	客串角色也称为客串演出，是指知名人士在表演艺术作品中的短暂亮相。
“VoiceActor”	配音表演是指演员仅使用声音，但不会出现在屏幕上。这种情况最常出现在动画中，但当演员的声音被配音覆盖时也会出现。
“双倍”	替身是指代替另一位演员表演，但不露脸的演员。
“MotionCaptureActor”	MotionCaptureActor 是指记录人类演员的动作，并使用该信息在 2D 或 3D 计算机动画中为数字角色模型添加动画效果的人员。

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

`roleName` 值	说明
“演员”	演员是指在传统媒体（如剧院）或现代媒体（如电影、广播和电视）中扮演角色的表演者。
“GuestStar”	“客串明星是指扮演虚构角色并出现在一集或几集中的演员。在某些情况下，客串明星可能会扮演重要的常驻角色，并且可能会多次出现在剧集中，尽管他们不是主要演员。如果演员有客串表演或客串出演节目，请将值设置为“GuestStar”。客串明星只能在剧集级别提供，不应在 TVSeries 级别添加。
“Guest”	“脱口秀节目的嘉宾。请注意，“GuestStar”是虚构的角色，而“Guest”是非虚构的客串。
“Announcer”	播音员是指为节目提供开场白和结束语、介绍主持人、参赛者和/或名人嘉宾、描述可用奖品、在录制前热场并让观众在休息期间保持娱乐状态的人员。
“Commentator”	解说员通常会在直播期间对游戏或活动进行实时解说。
“印象派”	模仿者或口技表演者是指通过模仿名人和卡通人物的声音、语音和举止来表演的表演者。
“主机”	介绍、展示或主持电视节目的人，通常充当节目与观众之间的中介。“主持人”通常是非虚构角色。
“CoHost”	与他人共同主持活动/计划的人员。
“GuestHost”	嘉宾主持人是指在常规主持人无法主持节目时，代替其主持节目的主持人（通常是脱口秀主持人）。
“新闻播报员”	通过电视新闻节目向公众播报/告知本地、国内和国际新闻和事件的人员。
“Correspondent”	特约记者或现场记者通常是杂志的记者或评论员，或为报纸、广播或电视新闻或其他类型的公司提供报道的代理，他们通常在偏远（往往是遥远）的地点工作。
“ShowJudge”	评委通常被认为是节目领域的专家，他们会以“评委”的身份对参加电视连续剧试镜和比赛的参赛者进行评判。
“Panelist”	电台或电视节目讨论小组或顾问小组的成员。
“参赛者”	竞赛或游戏节目的参赛者是指参与竞赛或游戏节目的人。
“StoryNarrator”	旁白者是指讲述某事的人，尤其是讲述小说或叙事诗情节的角色
“MusicalArtist”	“音乐人可以是个人、团体或虚构角色，他们通常会定期在观众面前表演，或者录制音乐曲目或音乐专辑。只有当某些音乐作品的演职员表表明作曲家和作词家也以主要表演者的身份做出了贡献时，他们才应具有此类型。此类型可用于将永久音乐人或音乐人团体以及客座音乐人或音乐人团体与演出相关联。

区分演员的主角和配角

为了区分电视剧中的主要演员/常规演员和客串演员/配角，请仅在 TVSeries 实体上添加主要演员，仅在 TVEpisode 实体上添加客串演员或配角。确保未将主要演员/常规演员添加到 TVEpisode 实体中。

示例

`TVSeries`、`TVEpisode` 和 `TVSeason` 示例

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

`Actor` 属性示例

操作者的角色未知

如果演员的角色未知，我们建议仅使用 Person 或 PerformingGroup 类型提供演员信息

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

执行者的角色已知

如果已知执行者的角色，我们建议使用 PerformanceRole 类型提供执行者信息

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

部分演员的已知角色

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

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

电视节目的内容标记属性 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

规范表

TVSeries

TVEpisode

TVSeason

执行者规范

使用 Person 或 PerformingGroup 类型

使用 PerformanceRole 类型

可接受的角色名称

区分演员的主角和配角

示例

TVSeries、TVEpisode 和 TVSeason 示例

TVSeries

TVEpisode

TVSeason

Actor 属性示例

操作者的角色未知

执行者的角色已知

部分演员的已知角色

相关页面

电视节目的内容标记属性

使用 `Person` 或 `PerformingGroup` 类型

使用 `PerformanceRole` 类型

`TVSeries`、`TVEpisode` 和 `TVSeason` 示例

`Actor` 属性示例