图片属性

本部分详细介绍了电影、电视节目、直播电视节目和体育赛事的 image 内容标记属性。此标记可让提供商描述图片类型（例如，图片是标题、背景还是图标图片）及其建议用途。

规格表

可以为 Movie、TVSeries、TVSeason、TVEpisode、SportsEvent 或 BroadcastEvent 实体类型提供 image 属性。下表介绍了 image 属性的可用属性。请注意，属性 additionalProperty 包含一个名为 contentAttributes 的自定义属性名称，其中包含一个值数组，用于描述图片类型及其预期用途。

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

必需（如果适用）- 与图片关联的虚构角色。如果 contentAttribute 包含 castInCharacter，则必须提供此值。
inLanguage 文本 必需（如果适用）- 图片中使用的文字所用的语言。使用 IETF BCP 47 标准中的一种语言代码。 如果图片包含 hasTitle 的 contentAttribute，则必须提供此属性。
regionsAllowed Place 推荐 - 允许显示该图片的区域。如果未指定，则假定允许在所有地方显示该图片。以 ISO 3166 格式指定国家/地区。
datePublished 日期

必需（如果适用） - 图片的可用日期，采用 ISO 8601 格式（包括时区）。

  • 日期可以设置为未来的日期。

如果图片的使用存在时间限制，并且在指定日期之前不得显示该图片，则此属性是必需的。如果不存在此类限制，则可以省略。必须在 datePublished 之前至少 7 天在 Feed 中提供相应图片。这将提高内容在 Google 平台上按时展示的几率。

expires 日期

必需（如果适用） - 图片的失效日期，采用 ISO 8601 格式（包括时区）。

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

您必须在到期日期前至少 7 天在 Feed 中更新到期日期。这将提高内容在到期日停止在 Google 平台上显示的可能性。

audience 观众群 推荐 - 此图片的预期或首选受众群体。
audience.geographicArea AdministrativeArea 推荐 - 此图片的预期或首选区域。 相比之下，使用 regionsAllowed 可指定硬性限制。如果未指定 audience.geographicArea，则系统会假定该视频可在所有地方使用。以 ISO 3166 格式指定国家/地区。
copyrightHolder Organization 或 Person 建议 - 拥有图片版权的一方。
keywords 文本 推荐 - 用于描述此图片的关键字或标签。 您可以使用数组提供多个 keywords。例如，["feature, biography"]
name 文本 推荐 - 图片的名称。
width 整数 可选 - 图片的正整数宽度（以像素为单位，例如 1920）。请勿包含单位字符串，例如 "px"。
height 整数 可选 - 图片的高度（以像素为单位，例如 1080），为正整数。请勿包含单位字符串，例如 "px"。

contentAttributes

image 的 contentAttributes 属性用于描述图片的类型并定义其建议用途。下表中的类别包含提供商必须为每个 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：主要人物位于图片左侧，右侧相对空旷，可用于放置文字和界面叠加层。

为确保有效，最多只能包含其中一个位置。

示例图片及其预期用途

一个 TV 界面，其中显示了带有文本和界面叠加层的背景图片。
一个电视界面，在背景图片上显示带有海报图片的轮播界面。
包含海报图片和背景 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 以及 forLightBackground 和 forDarkBackground）

 1800x1000

提交图片时，请遵循以下准则：

  1. 图片必须采用 JPEG、PNG 或 WebP 格式。
  2. 添加您能找到的分辨率最高的图片。
  3. 文件大小不得超过 20 MB。
  4. 最好提供 centered 张图片。某些产品还可以使用 rightCentered 和 leftCentered 背景图片，因此如果您有这些图片，也可以添加。
  5. 我们更倾向于使用同时适用于 smallFormat 和 largeFormat 的图片。
  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"]
        }
      ]
    }]
}