电影的内容标记属性

本部分详细介绍了 Movie 实体类型的内容标记属性。

规范表

属性 预期类型 说明
@context 文本 必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]
  • 其中“xx”代表 Feed 中字符串的语言。每个根实体上下文的 @language 都应设置为 BCP 47 格式的适当语言代码。例如，如果语言设置为西班牙语，系统会假定名称也是西班牙语，即使字幕/配音语言是英语也是如此。
@type 文本 必填 - 对于电影，始终设置为 Movie。
@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/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 如果适用，则必须提供 - 一个操作标记对象，用于提供操作的详细信息。
  • 如果内容可在视频点播 (VoD) 平台上播放，则必须提供此属性；Action 标记对象需要提供相应内容的深层链接。
  • 如果内容在 LiveTV 频道上提供，则此属性为可选属性；关联的 BroadcastService 实体会改为提供频道的深层链接。
  • Movie 可同时用于 VOD 和直播电视。
使用数组指定多个区域中的不同深层链接。请参阅支持多个区域和语言示例。
sameAs 网址 强烈建议可识别相应电影的参考网页的网址；例如，电影的维基百科页面。此属性必须与 url 属性不同。
inLanguage 文本 电影的原始语言，采用 BCP 47 格式。
genre 文本 所有相关类型的有序列表。例如：[“动作”“时尚”“环境”“足球”]
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 组织或个人 可选 - 发布此实体的组织或个人。
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 对于成人内容，此属性为必需属性；对于其他内容，强烈建议提供- 总体内容分级。如果内容分级以文本字符串的形式提供，则接受以下两种变体：
  • 分级机构，位于分级前面，中间有空格。例如，美国机构“MPAA”的“PG-13”分级应描述为“MPAA PG-13”。请参阅代理机构列表。
  • 值为“RATING NOT KNOWN”（不区分大小写），表示您不知道电影的分级。
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 设置为以下任一项：
  • Home Release：出售或出租供家庭观看的版本。
  • Theatrical Release：在影院上映的版本。
  • International Release：经过编辑以在国际上发布的版本。
  • Remastered：图片和/或音频已改进到更高标准的版本。
  • Unrated：未经 MPAA 或类似机构审核的版本。
  • Director Cut：表示导演自己批准的剪辑版本。
  • Extended Cut：时长比影院上映版本更长的版本。
workExample 影片 指定影片的变体。请在主要 Movie 实体中添加此属性，而不是在变体版本的 Movie 实体中添加。
workExample.@id 网址 对于 Movie 款式/规格，此属性提供其所属 Movie 实体的 @id。
workExample.@type 文本 必需 - 始终设置为 Movie。对于具有多个变体的 Movie，此值可以表示为数组。
workExample.@id 网址 必需 - Movie 变体的 @id。
workExample.name 文本 必需 - Movie 变体的名称。
workExample.category 文本 必填 - 特定版本的影片变体类型。将类别设置为以下任一项：
  • Home Release：出售或出租供家庭观看的版本。
  • Theatrical Release：在影院上映的版本。
  • International Release：经过编辑以在国际上发布的版本。
  • Remastered：图片和/或音频已改进到更高标准的版本。
  • Unrated：未经 MPAA 或类似机构审核的版本。
  • Director Cut：表示导演自己批准的剪辑版本。
  • Extended Cut：时长比影院上映版本更长的版本。

示例

主影片

一部包含删减版变体的电影。

{
  "@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"
}

如需了解与这些媒体资源相关的主题，请参阅以下页面：