本部分详细介绍了适用于影视内容的 image
的内容标记属性
节目。通过此标记,提供商可以说明图片的类型,例如
标题、背景或标志性图片及其使用建议。
规格表
image
属性可以用于:
Movie
,
TVSeries
,
TVSeason
,
或 TVEpisode
实体类型。下表介绍了
image
属性。请注意,additionalProperty
属性包含一个
名为 contentAttributes
的自定义属性名称,
用于存储描述图片类型及其预期用途的值数组。
属性 | 预期类型 | 说明 |
---|---|---|
@context |
文本 | 必需 - 始终设置为 "http://schema.org" 。 |
@type |
文本 | 必需 - 始终设置为 ImageObject 。 |
contentUrl |
网址 | 必需 - 图片的网址。 |
additionalProperty |
PropertyValue | 必需 - 定义属性 contentAttributes 。
,说明了映像类型及其预期用途。如需了解更多详情,
读取
contentAttributes 。 |
character |
Person |
如果适用,则为必填 - 与
图片。如果 |
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
:占位图形位于靠左 图片,使右侧对于文本和界面而言相对空白 叠加层。
为有效,请最多包含其中一个位置。
显示预期用途的图片示例
![](https://developers.google.cn/static/actions/media/images/image-properties-1.png?authuser=0000&hl=fi)
![](https://developers.google.cn/static/actions/media/images/image-properties-2.png?authuser=0000&hl=fi)
![](https://developers.google.cn/static/actions/media/images/image-properties-3.png?authuser=0000&hl=fi)
iconic
映像。![](https://developers.google.cn/static/actions/media/images/image-properties-4.png?authuser=0000&hl=fi)
sceneStill
映像。示例图片及其 contentAttributes
![](https://developers.google.cn/static/actions/media/images/image-properties-5.png?authuser=0000&hl=fi)
contentAttributes: ["iconic", "poster", "centered",
"hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat",
"largeFormat"]
![](https://developers.google.cn/static/actions/media/images/image-properties-6.png?authuser=0000&hl=fi)
contentAttributes: ["iconic", "background", "centered",
"smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright",
"noMatte"]
![](https://developers.google.cn/static/actions/media/images/image-properties-7.png?authuser=0000&hl=fi)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers.google.cn/static/actions/media/images/image-properties-8.png?authuser=0000&hl=fi)
contentAttributes: ["iconic", "background",
"rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers.google.cn/static/actions/media/images/image-properties-9.png?authuser=0000&hl=fi)
contentAttributes: ["iconic", "poster", "smallFormat",
"largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers.google.cn/static/actions/media/images/image-properties-10.png?authuser=0000&hl=fi)
contentAttributes: ["iconic", "poster", "largeFormat",
"hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers.google.cn/static/actions/media/images/image-properties-11.png?authuser=0000&hl=fi)
contentAttributes: ["castInCharacter", "hasTitle",
"hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character:
{name: "Captain Pulsar"}
![](https://developers.google.cn/static/actions/media/images/image-properties-12.png?authuser=0000&hl=fi)
contentAttributes: ["logo", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered", "smallFormat",
"largeFormat"]
![](https://developers.google.cn/static/actions/media/images/image-properties-13.png?authuser=0000&hl=fi)
contentAttributes: ["logo", "hasTitle", "hasLogo"
"noCopyright", "noMatte", "centered", "transparentBackground",
"forLightBackground", "forDarkBackground", "smallFormat",
"largeFormat"]
![](https://developers.google.cn/static/actions/media/images/image-properties-14.png?authuser=0000&hl=fi)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"hasCopyright", "noMatte"]
![](https://developers.google.cn/static/actions/media/images/image-properties-15.png?authuser=0000&hl=fi)
contentAttributes: ["iconic", "poster", "centered",
"noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat",
"largeFormat"]
![](https://developers.google.cn/static/actions/media/images/image-properties-16.png?authuser=0000&hl=fi)
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, |
600x800 | |||||
16:9, |
3840x2160 | |||||
2:3, |
1000x1500 | |||||
3:4, |
600x800 | |||||
1:1,显示徽标 (hasLogo ) |
600x600 | |||||
4:3,频道徽标 (logo ) |
800x600 | |||||
1:1,频道徽标 (logo ) |
600x600 | |||||
16:9,频道徽标 (logo ) |
3840x2160 | |||||
9:5, |
1800x1000 |
提交图片时,请遵循以下准则:
- 图片必须为 JPEG、PNG 或 WebP 格式。
- 添加分辨率最高的图片。
- 文件大小不得超过 20 MB。
- 首选图片(
centered
)。rightCentered
和leftCentered
背景图片还会被某些产品使用,因此您可以 - 我们希望图片同时适用于
smallFormat
和largeFormat
。 - 除了上述尺寸的图片外,您还可以添加图片尺寸 表格。
- 验证每张图片的宽高比是否均为 上表。否则,系统会显示警告。
具有架构的示例图片
以下示例展示了如何为与以下项目关联的图片设置架构格式: 电影或电视节目。
包含两个角色的电影背景图片
![](https://developers.google.cn/static/actions/media/images/image-properties-8.png?authuser=0000&hl=fi)
{
"@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"]
}
]
}
}
仅限两个地区的电视连续剧背景图片
![](https://developers.google.cn/static/actions/media/images/image-properties-8.png?authuser=0000&hl=fi)
{
"@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"]
}
]
}
}
面向两个地区的电影海报图片
![](https://developers.google.cn/static/actions/media/images/image-properties-9.png?authuser=0000&hl=fi)
{
"@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"]
}
]
}
}
包含韩文和英文的大幅格式电影海报
![](https://developers.google.cn/static/actions/media/images/image-properties-17.png?authuser=0000&hl=fi)
{
"@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"]
}
]
}]
}