电影的内容标记属性

本部分详细介绍了 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 可抓取的有效规范网址。
。如需了解播放的深层链接,请改为参阅 target 对象的 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 必需(如果适用)- 一个操作标记对象,用于提供操作的详细信息
  • 如果内容可通过视频点播 (VoD) 播放,则该属性为必需属性;操作标记对象需要提供内容的深层链接
  • 如果内容在 LiveTV 频道播出,则此属性为可选属性;而关联的 BroadcastService 实体则提供频道的深层链接。
  • VoD 和 LiveTV 均支持 Movie
您可以使用数组在多个区域中指定不同的深层链接。请参阅多区域和多种语言示例。
sameAs 网址 强烈推荐为什么?指向可以标识该电影的参考网页的网址;例如该电影的维基百科网页。此属性必须与 url 属性不同。
inLanguage 文本 电影的原始语言,采用 BCP 47 格式。
genre 文本 所有相关类型的有序列表。例如:["动作", "时尚", "环境", "足球"]
keywords 文本 用于描述此内容的关键字或标签。您还可以使用一系列关键字。例如,["feature, biography"] 可以是描述内容的关键字数组。
releasedEvent PublicationEventFeaturedEventExclusiveEvent 强烈推荐为什么?- PublicationEvent 用于指定发布商内容的原始(全球或本地)发行,例如电影的原始影院上映日期。

此外,您可以使用 FeaturedEvent 指明您的服务以原创、精选、特别等形式推广此内容。

ExclusiveEvent 指定您的服务拥有独家发行权,并指明您的发行地点和时间。

有关详细信息和示例,请参阅示例部分
releasedEvent.@type 文本 必需属性 - 请务必将此属性始终设置为下列值之一:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 国家/地区 必需 - 与此事件相关的地区。

对于 PublicationEvent,这是指内容发布所在的地区。

对于 FeaturedEventExclusiveEvent,这是指内容被纳入精选或专享的地区。

对于国家/地区,请使用 ISO 3166 代码。如需指示世界上的任何地方,请设置为 EARTH
releasedEvent.startDate DateDateTime 建议 - 对于 ExclusiveEvent 为必需 - 实体的出版开始日期。

对于 PublicationEvent,此字段表示此实体的首次发布日期,例如电影在影院首次上映的日期。

对于 ExclusiveEventFeaturedEvent,此字段表示实体的独家或精选内容的开始日期。
releasedEvent.endDate DateDateTime 建议 - 对于 ExclusiveEvent 是必需的 - 此字段仅适用于 ExclusiveEventFeaturedEvent 类型。

对于 ExclusiveEvent,此字段表示内容权利到期的日期。

对于 FeaturedEvent,此字段代表提供方最近一次推介该实体的日期。

如果内容是永久独家内容或精选内容,请将 endDate 设置为从当前日期起 20 年后的日期。
releasedEvent.publishedBy OrganizationPerson 可选 - 发布此实体的组织或个人。
description 文本 强烈推荐为什么?电影的剧情简介。比起事实总结,最好采用剧情大纲。最多 300 个字符。
duration 时长 影片的片长(采用 ISO 8601 格式)。请使用以下格式:“PT00H00M”。
director Person 强烈推荐为什么?电影的导演。
actor Person 强烈推荐为什么?电影的演职人员。
producer OrganizationPerson 强烈推荐为什么?电影的制片人。
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 文字评分 必须为成人内容提供,否则强烈建议提供。为什么?- 总体内容分级。如果内容分级以文本字符串的形式指定,可以接受以下两种形式:
  • 分级机构在评分前面附加了一个空格。例如,“PG-13”评级由代理机构“MPAA”应称为“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: 特定于语言区域的受欢迎程度优先于全球 (EARTH) 的热门程度
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"
}

您可以访问以下页面,了解与这些属性相关的主题: