图片属性

本部分详细介绍了 image 适用于电影和电视节目的内容标记属性。通过此标记,提供商可以描述图片类型(例如图片是标题、背景还是标志性图片),以及图片的推荐用途。

规范表

image 属性可以为 MovieTVSeriesTVSeasonTVEpisode 实体类型提供。下表介绍了 image 属性的可用属性。请注意,additionalProperty 属性包含一个名为 contentAttributes 的自定义属性名称,该名称包含一个数组,用于描述图片类型及其预期用途。

属性 预期类型 说明
@context 文本 必需 - 始终设置为 "http://schema.org"
@type 文本 必需 - 始终设置为 ImageObject
contentUrl 网址 必需 - 图片的网址。
additionalProperty PropertyValue 必需 - 定义 contentAttributes 属性,用于描述图片类型及其预期用途。如需了解详情,请阅读 contentAttributes
character 人称

如果适用(必需)- 与图片相关联的虚构字符。如果 contentAttribute 包含 castInCharacter,则必须执行此操作。

inLanguage 文本 如果适用(必需)- 图片中使用的文本语言。使用 IETF BCP 47 标准中的一种语言代码。如果图片包含 hasTitlecontentAttribute,此属性为必需属性。
regionsAllowed Place 建议 - 允许映像的区域。如果未指定,系统会假定图片在各处均允许运行。 以 ISO 3166 格式指定国家/地区。
datePublished 日期

如果适用(如果适用) - 映像发布的日期,采用 ISO 8601 格式(包括时区)。

  • 日期可以是将来的日期。

如果图片在时间上受限制,且图片在给定日期之前不得显示,则必须提供此属性。如果不存在此类限制,则可以忽略。相应的 Feed 必须比发布日期提前至少 7 天在 Feed 中提供。这可以提高内容按时显示在 Google 平台上的几率。

expires 日期

如果适用(如果适用) - 图片在超过该日期后不再可用,采用 ISO 8601 格式(包括时区)。

  • 如果内容在发布后始终可用,您可以省略此属性。

Feed 中必须至少包含过期日期的 7 天才能更新到期日期。这样可提高相应内容在过期日期前在 Google 平台上停止展示的几率。

audience 观众群 Recommended - 此图片的预期或首选受众群体。
audience.geographicArea 行政区 Recommended - 此图片的预期或首选区域。请使用 regionsAllowed 指定硬性限制。如果未指定 audience.geographicArea,系统会假定其在所有地方使用。请以 ISO 3166 格式指定国家/地区。
copyrightHolder 组织人员 建议 - 持有图片版权的一方。
keywords 文本 推荐 - 用于描述此图片的关键字或标记。 可以使用数组提供多个 keywords。例如 ["feature, biography"]
name 文本 Recommended - 图片的名称。

contentAttributes

imagecontentAttributes 属性描述图片的类型,并定义图片的建议用途。以下列表中的类别包括提供程序对于每个 ImageObject 必须包含的 contentAttributes 值。

类型

  • iconic:展示节目的插图图片。通常是一种艺术性渲染
  • sceneStill:选自节目的图片。
  • castInCharacter:演职人员的照片中的人物。如果您使用此值,还应添加 character 属性以标识图片中的特定字符。如果有多个字符(例如,在投射集成中),请以数组的形式添加多个 character 属性。
  • logo:图片仅包含徽标。它可以是图形徽标,也可以是标题徽标。添加相应叠加层以指定具体内容。

要生效,请使用其中一种类型。

  • poster:节目的海报图片。在计算机界面中,这些内容可以在轮播界面中使用。这些内容不一定包含节目的标题。
  • background:适合用作带文本或界面叠加层的背景的图片。这些图片不包含文字。

为有效,请添加下列建议用途之一。

是否适合儿童

  • smallFormat:适合手机等小屏幕的图片。图片中的所有文字或徽标在小屏幕上都清晰可辨。
  • largeFormat:适合大屏幕或印刷海报的图片。

图片可以同时使用这两个值。

背景适宜性

  • forDarkBackground:适合在深色背景上使用的图片(通常是透明徽标)。
  • forLightBackground:适合在浅色背景上使用的图片(通常是透明徽标)。

为有效,只能使用一个背景适宜性值。

叠加层

  • hasTitle:节目的名称,或者图片中包含的角色或演员的名称。请务必为图片添加 inLanguage 属性。
  • noTitle:图片不包含标题。
  • hasLogo:图片包含电影或电视节目的徽标、内容所有者或分销商。
  • noLogo:图片不包含徽标。
  • hasCopyright:图片包含可见的版权通知。
  • noCopyright:图片不包含可见的版权通知。一般来说,未经修改,Google 无法使用此类图片。
  • hasMatte:图片有哑光效果。这可以是水平(字母框)、垂直(邮筒模式)或两者(窗口框)。有时,图片适合哑光以适应宽高比。未经修改,Google 通常无法使用此类图片。
  • noMatte:图片没有哑光。
  • transparentBackground:图片背景是透明的。这通常用于仅用作标题或徽标的图片,而不用于任何其他内容。

为有效,只能使用一个标题、一个徽标、一个版权和一个哑光属性。

主导者的位置

  • centered:主导者放置在图片的中心。
  • rightCentered:占据主导地位的位置靠近图片的右侧,对于文本和界面叠加层,左侧则相对为空。
  • leftCentered:主要部分靠近图片左侧,使右侧对于文本叠加层和界面叠加层而言为空。

为了保证有效期,最多只能包含其中一个位置。

符合预期用途的图片示例

显示背景图片并包含文字和界面叠加层的电视界面。
一个电视界面,其中显示了背景图片上有海报图片的轮播界面。
具有海报图片和背景图片 iconic 的移动界面。
具有海报图片和背景图片 sceneStill 的移动界面。

示例图片及其 contentAttributes

contentAttributes: ["iconic", "poster", "centered", "hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat", "largeFormat"]
contentAttributes: ["iconic", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
contentAttributes: ["iconic", "background", "rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
contentAttributes: ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]
contentAttributes: ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]
contentAttributes: ["castInCharacter", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character: {name: "Captain Pulsar"}
contentAttributes: ["logo", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "smallFormat", "largeFormat"]
contentAttributes: ["logo", "hasTitle", "hasLogo" "noCopyright", "noMatte", "centered", "transparentBackground", "forLightBackground", "forDarkBackground", "smallFormat", "largeFormat"]
contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "noMatte"]
contentAttributes: ["iconic", "poster", "centered", "noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat", "largeFormat"]
contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "hasMatte"]

Google 产品所需的图片类型

不同的 Google 产品和界面需要不同的图片类型和宽高比。为确保内容在所有 Google 产品中都能正确显示,我们要求提供商提供下表中的所有图片类型。

宽高比和 contentAttributes 最低分辨率(像素) 电影 电视连续剧 电视剧季 电视剧集 广播服务
16:9,iconic poster 3840x2160
2:3,iconic poster 1000x1500
4:3,iconic poster 800x600
1 对 1,iconic poster 600x600

3:4,iconic poster

600x800

16:9,iconic background [首选] 或 sceneStill

3840x2160

2:3, iconic background [首选] 或 sceneStill

1000x1500

3:4、iconic background [首选] 或 sceneStill

600x800
1:1,显示徽标 (hasLogo) 600x600
4:3,频道徽标 (logo) 800x600
1:1,频道徽标 (logo) 600x600
16:9,频道徽标 (logo) 3840x2160

9:5,hasTitle logo(带有 transparentBackground,以及 forLightBackgroundforDarkBackground

1800x1000

提交图片时,请遵循以下指南:

  1. 图片必须为 JPEG、PNG 或 WebP 格式。
  2. 添加分辨率最高的图片。
  3. 文件大小不得超过 20 MB。
  4. 建议使用 centered 张图片。某些产品还可以使用 rightCenteredleftCentered 背景图片,因此如果您有图片,可以将其添加进来。
  5. 我们首选同时适用于 smallFormatlargeFormat 的图片。
  6. 除了上表列出的图片大小之外,您还可以添加图片大小。
  7. 验证每张图片的宽高比是否是上表中列出的某个常用值。否则,系统会显示警告。

使用架构的图片示例

以下示例展示了如何为与电影或电视节目关联的图片设置架构格式。

包含两个背景的电影背景图片

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/mountain_view",
  "url": "http://www.example.com/my_favorite_movie",

  ...,

  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mountain View: A Movie poster",
    "Keywords": ["Mauren, Lord Wingflap the Destroyer"],
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "character": [
      { "@type": "Person", "name": "Mauren" },
      { "@type": "Person", "name": "Lord Wingflap the Destoyer" },
    ],
    "copyrightHolder": {
      "@type": "Organization",
      "name": " ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": {
        "@type": "Audience",
        "geographicArea": [{"@type": "Country", "name": "US"},
                           {"@type": "Country", "name": "GB"},
                           {"@type": "Country", "name": "CA"},
                           {"@type": "Country", "name": "AU"}]
    },
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
                   "noCopyright", "noMatte", "smallFormat", "largeFormat"]
      }
    ]
  }
}

仅限两个区域显示的 TVSeries 背景图片

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "TVSeries",
  "@id": "http://www.example.com/mountain_view",
  "url": "http://www.example.com/mountain_view",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mountain View: A TV Show",
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "regionsAllowed": [{ "@type": "Country", "name": "US" },
                       { "@type": "Country", "name": "GB" }],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "background", "rightCentered", "smallFormat",
                  "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
      }
    ]
  }
}

两个区域对应的电影海报图片

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier",
    "contentUrl": "http://example.com/images/pulsar-quest.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": [{ "@type": "Country", "name": "US" },
                 { "@type": "Country", "name": "GB" }],
    "character": [
      {
        "@type": "Person",
        "name": "Captain Pulsar"
      }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle",
                  "hasLogo", "noCopyright", "noMatte", "centered"]
      }
    ]
  }
}

大型韩语海报和海报

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": ["kr", "en"],
    "audience": { "@type": "Country", "name": "KR" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" },
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
  }
}

每个地区表示多张图片

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": [{
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest-us.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": ["en"],
    "audience": { "@type": "Country", "name": "US" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
    },{
      "@context": "http://schema.org",
      "@type": "ImageObject",
      "name": "Pulsar Quest: A New Frontier poster",
      "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
      "copyrightHolder": {
        "@type": "Organization",
        "name": "ExampleOrganization Studios, Inc."
      },
      "inLanguage": ["kr"],
      "audience": { "@type": "Country", "name": "KR" },
      "character": [
        { "@type": "Person", "name": "Captain Pulsar" },
        { "@type": "Person", "name": "Space Cadet Shaniah" },
        { "@type": "Person", "name": "Rove the Rover" }
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentAttributes",
          "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                    "noCopyright", "noMatte", "centered"]
        }
      ]
    }]
}

表示有时间限制的图片

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": [{
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest-jp.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "datePublished": "2022-10-31T17:00:00Z",
    "expires": "2025-10-31T16:59:59Z",
    "inLanguage": ["ja"],
    "audience": { "@type": "Country", "name": "JP" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
    },{
      "@context": "http://schema.org",
      "@type": "ImageObject",
      "name": "Pulsar Quest: A New Frontier poster",
      "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
      "copyrightHolder": {
        "@type": "Organization",
        "name": "ExampleOrganization Studios, Inc."
      },
      "datePublished": "2021-10-31T17:00:00Z",
      "expires": "2023-10-31T16:59:59Z",
      "inLanguage": ["kr"],
      "audience": { "@type": "Country", "name": "KR" },
      "character": [
        { "@type": "Person", "name": "Captain Pulsar" },
        { "@type": "Person", "name": "Space Cadet Shaniah" },
        { "@type": "Person", "name": "Rove the Rover" }
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentAttributes",
          "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                    "noCopyright", "noMatte", "centered"]
        }
      ]
    }]
}