本部分详细介绍了 Movie 实体类型的内容标记属性。
规范表
| 属性 | 预期类型 | 说明 |
|---|---|---|
@context |
文本 | 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
|
@type |
文本 | 必填 - 对于电影，始终设置为 Movie。 |
@id |
网址 | 必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。@id 必须满足以下要求：
url 符合作为标识符的所有要求，因此我们建议您将实体的 url 用作 @id。如需了解详情，请参阅标识符部分。 |
url |
网址 | 必填 - 内容的规范网址。Google 会使用此网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。url 必须满足以下要求：
urlTemplate 属性。 |
name |
文本 | 必需 - 电影的名称。
|
titleEIDR |
文本 | 强烈建议- EIDR（娱乐业标识注册）标识符，在最一般/抽象层面上表示影视作品。 例如，名为“捉鬼敢死队”的电影的 titleEIDR 为“10.5240/7EC7-228A-510A-053E-CBB8-J”。 |
editEIDR |
文本 | 强烈建议- EIDR（娱乐业标识注册）标识符，表示影视作品的特定剪辑 / 版本。 例如，名为“Ghostbusters”（幽灵鬼怪）的影片的 titleEIDR 为“10.5240/7EC7-228A-510A-053E-CBB8-J”，该影片有多个剪辑版本，例如“10.5240/1F2A-E1C5-680A-14C6-E76B-I”和“10.5240/8A35-3BEE-6497-5D12-9E4F-3”。提供 editEIDR 时， titleEIDR 属性为必需属性。 |
potentialAction |
WatchAction | 如果适用，则必须提供 - 一个操作标记对象，用于提供操作的详细信息。
|
sameAs |
网址 | 强烈建议可识别相应电影的参考网页的网址；例如，电影的维基百科页面。此属性必须与 url 属性不同。 |
inLanguage |
文本 | 电影的原始语言，采用 BCP 47 格式。 |
genre |
文本 | 所有相关类型的有序列表。例如：[“动作”“时尚”“环境”“足球”] |
keywords |
文本 | 用于描述此内容的关键字或标签。还允许使用关键字数组。例如，["feature, biography"] 可以是用于描述内容的关键字数组。 |
releasedEvent |
PublicationEvent、FeaturedEvent 或 ExclusiveEvent |
强烈建议- PublicationEvent 用于指定发布商的原始（全球或本地）内容发布日期，例如电影的原始影院上映日期。此外，使用 FeaturedEvent 可指明您的服务将此内容作为原创内容、精选内容、特别内容等进行营销。ExclusiveEvent 用于指定您的服务拥有独家分销权，并包含分销地点和时间。如需了解详情和示例，请参阅示例部分。 |
releasedEvent.@type |
文本 | 必需 - 请务必始终将此属性设置为以下各项之一：
|
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 |
组织或个人 | 可选 - 发布此实体的组织或个人。 |
description |
文本 | 强烈建议影片的剧情简介。最好提供剧情摘要，而不是事实摘要。字符数限制为 300 个字符。
|
duration |
时长 | 电影的时长，采用 ISO 8601 格式。请使用以下格式：“PT00H00M”。 |
director |
Person | 强烈建议电影的导演。 |
actor |
Person | 强烈建议电影的演员。 |
producer |
组织或个人 | 强烈建议电影的制片人。 |
image |
ImageObject | 对于 Google TV 是必需的：与电影相关的图片。如需详细了解应与 image 一起添加的必需属性和可选属性，请参阅图片属性。 |
trailer.description |
文本 | 预告片的说明。请参阅预告片示例。 |
trailer.inLanguage |
文本 | 预告片的语言（采用 BCP 47 格式）。 |
trailer.url |
网址 | 由相应制作工作室或授权来源公开托管并上传的预告片的网址。 |
trailer.regionsAllowed |
Place | 允许显示该媒体的区域。如果未指定，则假定允许在所有地方显示该视频。以 ISO 3166 格式指定国家/地区。 |
identifier |
PropertyValue | 强烈建议- 明确标识了此实体的外部 ID 或其他 ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。 |
review |
Review | 电影的评价 |
review.reviewRating |
评分 | 如果提供评价，则必须提供。用于指定评价中给出的评分。 |
contentRating |
Text 或 Rating | 对于成人内容，此属性为必需属性；对于其他内容，强烈建议提供- 总体内容分级。如果内容分级以文本字符串的形式提供，则接受以下两种变体：
|
contentRating.author |
组织 | 如果 contentRating 使用 Rating，则必填 - 分级机构的名称。 |
contentRating.ratingValue |
文本 | 如果 contentRating 使用 Rating，则必需 - 分级的值。 |
contentRating.advisoryCode |
文本 | 内容的警示代码。接受的值包括 D、FV、L、S 和 V。D = 对话、FV = 幻想暴力、L = 语言、S = 色情内容、V = 暴力。 |
popularityScore |
PopularityScoreSpecification | 强烈建议Google 会根据此评分以及其他信号来确定向用户播放哪些媒体。此评分表示相应内容相对于目录中其他内容的热门程度；因此，您 Feed 中所有实体以及目录中所有实体的评分比例需要保持一致。默认情况下，实体的热门程度得分设为 0。 |
popularityScore.@type |
文本 | 始终设置为 PopularityScoreSpecification。 |
popularityScore.value |
编号 | 一个非负数值，表示实体的受欢迎程度；得分越高，受欢迎程度越高。 |
popularityScore.eligibleRegion |
国家/地区 | 此人气指数适用的地区。如果热门程度得分适用于全球，请设为 EARTH。默认情况下，此属性设置为 EARTH。Note: 特定语言区域的热门程度优先于全球（地球）热门程度 |
category |
文本 | 如果适用则必填 - 如果实体是 Movie 变体，请填充此属性。将 category 设置为以下任一项：
|
workExample |
影片 | 指定影片的变体。请在主要 Movie 实体中添加此属性，而不是在变体版本的 Movie 实体中添加。 |
workExample.@id |
网址 | 对于 Movie 款式/规格，此属性提供其所属 Movie 实体的 @id。 |
workExample.@type |
文本 | 必需 - 始终设置为 Movie。对于具有多个变体的 Movie，此值可以表示为数组。 |
workExample.@id |
网址 | 必需 - Movie 变体的 @id。 |
workExample.name |
文本 | 必需 - Movie 变体的名称。 |
workExample.category |
文本 | 必填 - 特定版本的影片变体类型。将类别设置为以下任一项：
|
示例
主影片
一部包含删减版变体的电影。
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie",
"url": "http://www.example.com/my_favorite_movie",
"name": "My Favorite Movie",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie?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",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
"contentRating": "RATING NOT KNOWN",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 78,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"workExample": {
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut"
"category": "Extended Cut"
}
}
导演剪辑版变体
主电影的导演剪辑版。
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"url": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?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",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "http://www.example.com/example_package",
"identifier": "example.com:example_package"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
"contentRating": {
"@type": "Rating",
"author": "MPAA",
"ratingValue": "R",
"advisoryCode": "FV"
},
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "This is the extended cut of my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"exampleOfWork": {
"@id": "http://www.example.com/my_favorite_movie",
}
"category": "Extended Cut"
}
相关页面
如需了解与这些媒体资源相关的主题，请参阅以下页面：