本部分详细介绍了 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 |
文本 | Required - 影片的名称。
|
titleEIDR |
文本 | 强烈建议原因- EIDR（娱乐标识符注册）标识符，代表最一般/抽象级别的电影或电视作品。 例如，名为“Ghostbusters”的电影的 titleEIDR 为“10.5240/7EC7-228A-510A-053E-CBB8-J”。 |
editEIDR |
文本 | 强烈建议原因- EIDR（娱乐标识符注册）标识符，用于表示电影或电视作品的特定剪辑 / 版本。 例如，名为“Ghostbusters”且电影标题为“10.5240/7EC7-228A-510A-053E-CBB8-J”的影片经过了多次编辑，如“10.5240/1F2A-E1C5-680A-14C6-E4C6-540-14C6-540-14C6” titleEIDR 属性在提供 EditEIDR 时是必需的。 |
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 个。
|
duration |
时长 | 电影的运行时，采用 ISO 8601 格式。请使用以下格式：“PT00H00M”。 |
director |
人称 | 强烈建议原因影片的导演。 |
actor |
人称 | 强烈建议原因电影的演职人员。 |
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 |
文字或评分 | 必须提供成人内容，强烈建议提供，否则？- 总体内容分级。如果内容分级是以文本字符串的形式提供的，则会接受两种变体：
|
contentRating.author |
文字或组织 | 如果 contentRating 使用 Rating，则为必需项 - 分级机构的名称。 |
contentRating.ratingValue |
文本 | 如果 contentRating 使用 Rating，则为必需值 - 评分的值。 |
contentRating.advisoryCode |
文本 | 内容的建议代码。接受的值包括 D、FV、L、S 和 V；D = 对话、FV = 幻想暴力内容、L = 语言、S = 色情内容、V = 暴力内容。 |
popularityScore |
热门程度得分规范 | 强烈建议原因Google 根据这一得分及其他一些信号来确定为用户播放哪种媒体内容。此得分表示内容相对于您目录中其他内容的受欢迎程度；因此，该得分在各 Feed 之间在目录中的所有实体中必须保持一致。默认情况下，实体的热门程度分数设为 0。 |
popularityScore.@type |
文本 | 始终设置为 PopularityScoreSpecification。 |
popularityScore.value |
编号 | 非负数值，表示实体的热门程度；分数越高，表示热门程度越高。 |
popularityScore.eligibleRegion |
国家/地区 | 此热门程度得分适用的地区。如果热门程度得分是全球适用的，则设为 EARTH。默认情况下，此属性会设置为 EARTH。Note: 针对特定语言区域的热门程度高于全球 (EARTH) 热门程度 |
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"
}
相关页面
请查看以下页面，了解与这些属性相关的主题：