图片属性

本部分详细介绍了适用于影视内容的 image 的内容标记属性 节目。通过此标记，提供商可以说明图片的类型，例如 标题、背景或标志性图片及其使用建议。

规格表

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

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

如果适用，则为必填 - 与 图片。如果contentAttribute，则必须提供 包含 castInCharacter。
inLanguage 文本 如果适用，则必须提供 - 此 图片。使用 IETF BCP 47 标准。 如果图片包含 contentAttribute hasTitle，此属性为必需属性。
regionsAllowed Place 推荐 - 允许上传映像的区域。如果不是 ，那么系统会假定该图片在任何位置都适用。 指定以下国家/地区： ISO 3166 格式。
datePublished 日期

必需（如果适用）- 提供图片的日期（以 感光度 8601 格式（包括时区）。

  • 日期可设置为将来的日期。

如果对图像的使用有基于时间的限制，则此属性为 如果图片不得在指定日期之前显示，则此属性为必需属性。如果没有 则可以忽略。对应的图片 至少在发布日期前 7 天在 Feed 中提供。这将 增加内容准时在 Google 平台上展示的几率。

expires 日期

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

  • 如果内容在发布后始终可供查看，则可以忽略此字段 属性。

对过期日期所做的任何更新都必须至少在 Feed 中进行。 到期前 7 天。这样可提高内容停止播放的几率 在到期日在 Google 平台上展示。

audience 观众群 推荐 - 此广告格式的目标受众群体或首选受众群体 图片。
audience.geographicArea AdministrativeArea 推荐 - 此映像的目标区域或首选区域。 相比之下，使用 regionsAllowed 指定硬性 限制。如果未指定 audience.geographicArea， 那么系统会假定它适用于所有位置指定 国家/地区 ISO 3166 格式。
copyrightHolder 组织 或 Person 推荐 - 版权持有者 图片。
keywords 文本 建议 - 用于描述此图片的关键字或标记。 可以使用数组提供多个 keywords。例如：["feature, biography"]
name 文本 推荐 - 映像名称。

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 界面。
。
显示以海报图片为背景的轮播界面的 TV 界面 图像。
。 <ph type="x-smartling-placeholder">
</ph>
包含海报图片和背景的移动界面 iconic 映像。
。 <ph type="x-smartling-placeholder">
</ph>
包含海报图片和背景的移动界面 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"]
      }
    ]
  }
}

仅限两个地区的电视连续剧背景图片

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