本部分详细介绍了 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 |
文本 | 所有相关类型的有序列表。例如：["动作", "时尚", "环境", "足球"] |
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 示例。 |
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 |
PopularityScoreSpecification | 强烈推荐为什么？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"
}
相关页面
您可以访问以下页面，了解与这些属性相关的主题：