本部分详细介绍了 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（娱乐业标识注册）标识符，用于表示影视作品的特定剪辑 / 版本。 例如，电影《捉鬼敢死队》的标题 EIDR 为“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 |
文本 | 所有相关流派的有序列表。例如：["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 |
Date 或 DateTime | 推荐 - ExclusiveEvent 必需 - 实体的发布开始日期。对于 PublicationEvent，这表示实体的初始发布日期，例如电影首次在影院上映的日期。对于 ExclusiveEvent 和 FeaturedEvent，这表示实体成为独家内容或精选内容的开始日期。 |
releasedEvent.endDate |
Date 或 DateTime | 推荐 - ExclusiveEvent 必需 - 仅适用于 ExclusiveEvent 和 FeaturedEvent 类型。对于 ExclusiveEvent，此属性表示内容版权的到期日期。对于 FeaturedEvent，此属性表示提供方最后一次推荐相应实体的日期。如果内容是永久独家或推荐内容，请将 endDate 设置为当前日期起 20 年后的日期。 |
releasedEvent.publishedBy |
Organization 或 Person | 可选 - 发布相应实体的组织或个人。 |
description |
文本 | 强烈推荐 为什么？电影的剧情简介。剧情简介优先于事实摘要。300 个字符。
|
duration |
时长 | 电影的播放时长，采用 ISO 8601 格式。请使用“PT00H00M”格式。 |
director |
Person | 强烈推荐 为什么？电影的导演。 |
actor |
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。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。 |
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"
}
相关页面
如需了解与这些媒体资源相关的主题，请参阅以下页面：