本部分详细介绍了 image
适用于电影和电视节目的内容标记属性。通过此标记,提供商可以描述图片类型(例如图片是标题、背景还是标志性图片),以及图片的推荐用途。
规范表
image
属性可以为 Movie
、TVSeries
、TVSeason
或 TVEpisode
实体类型提供。下表介绍了 image
属性的可用属性。请注意,additionalProperty
属性包含一个名为 contentAttributes
的自定义属性名称,该名称包含一个数组,用于描述图片类型及其预期用途。
属性 | 预期类型 | 说明 |
---|---|---|
@context |
文本 | 必需 - 始终设置为 "http://schema.org" 。 |
@type |
文本 | 必需 - 始终设置为 ImageObject 。 |
contentUrl |
网址 | 必需 - 图片的网址。 |
additionalProperty |
PropertyValue | 必需 - 定义 contentAttributes 属性,用于描述图片类型及其预期用途。如需了解详情,请阅读 contentAttributes 。 |
character |
人称 |
如果适用(必需)- 与图片相关联的虚构字符。如果 |
inLanguage |
文本 | 如果适用(必需)- 图片中使用的文本语言。使用 IETF BCP 47 标准中的一种语言代码。如果图片包含 hasTitle 的 contentAttribute ,此属性为必需属性。 |
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
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
:主要部分靠近图片左侧,使右侧对于文本叠加层和界面叠加层而言为空。
为了保证有效期,最多只能包含其中一个位置。
符合预期用途的图片示例
示例图片及其 contentAttributes
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
的图片。 - 除了上表列出的图片大小之外,您还可以添加图片大小。
- 验证每张图片的宽高比是否是上表中列出的某个常用值。否则,系统会显示警告。
使用架构的图片示例
以下示例展示了如何为与电影或电视节目关联的图片设置架构格式。
包含两个背景的电影背景图片
{
"@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"]
}
]
}]
}