本節針對電影和電視節目提供 image
的內容標記屬性。這個標記可讓提供者描述圖片類型,例如標題、背景或代表性圖片,以及建議用途。
規格表
可以為 Movie
、TVSeries
、TVSeason
或 TVEpisode
實體類型提供 image
屬性。下表說明 image
屬性的可用屬性。請注意,additionalProperty
屬性包含名為 contentAttributes
的自訂屬性名稱,其中包含一組值,用於說明圖片類型和預定用途。
屬性 | 預期類型 | 說明 |
---|---|---|
@context |
Text | 必要 - 一律設為 "http://schema.org" 。 |
@type |
Text | 必要 - 一律設為 ImageObject 。 |
contentUrl |
網址 | 必要 - 圖片的網址。 |
additionalProperty |
PropertyValue | 必要 - 定義 contentAttributes 屬性,該屬性說明圖片的類型及其用途。詳情請參閱 contentAttributes 。 |
character |
Person |
必要 (如果適用):與圖片相關聯的虛構字元。如果 |
inLanguage |
Text | 必要 (如果適用) - 圖片中使用的文字語言。請使用 IETF BCP 47 標準中的其中一個語言代碼。如果圖片包含 hasTitle 的 contentAttribute ,此屬性為必要屬性。 |
regionsAllowed |
地點 | 建議做法 - 允許映像檔的區域。如未指定,系統會假設圖片可以在所有位置使用。請使用 ISO 3166 格式指定國家/地區。 |
datePublished |
日期 | 必要 (如果適用) - 圖片可供使用的日期,採 ISO 8601 格式 (含時區)。
如果圖片的使用時機設有時限,如果圖片未在指定日期前顯示圖片,則必須提供這項屬性。如果沒有這類限制,則可省略。您必須在動態饋給已發布的日期至少 7 天前,將對應的圖片提供給動態饋給。這種做法有助於提高內容在 Google 途徑中曝光的機會。 |
expires |
日期 | 必要 (如果適用) - 不再提供圖片的日期,採 ISO 8601 格式 (包括時區)。
如要更新到期日,所有到期日都要在到期日前 7 天更新。這麼做可以讓到期日在 Google 途徑上顯示內容。 |
audience |
觀眾 | 建議項目 - 這張圖片的預期或首選目標對象。 |
audience.geographicArea |
行政區 | 建議使用 - 這張圖片的預期或偏好區域。相反地,請使用 regionsAllowed 指定嚴格限制。如未指定 audience.geographicArea ,系統會假設該 API 適用於所有地區。請使用 ISO 3166 格式指定國家/地區。 |
copyrightHolder |
機構或使用者 | 建議做法 - 持有圖片版權的一方。 |
keywords |
Text | 建議使用 - 用來描述這張圖片的關鍵字或標記。您可以使用陣列提供多個 keywords 。例如 ["feature, biography"] |
name |
Text | 建議做法 - 圖片的名稱。 |
content 屬性
image
的 contentAttributes
屬性會說明圖片的類型並定義其建議用途。下列清單中的類別包含供應商必須在每個 ImageObject
中包含的 contentAttributes
值。
類型
iconic
:描繪節目的插圖圖片。通常算是藝術轉譯。sceneStill
:節目摘錄的圖片。castInCharacter
:演員角色中出現的照片。如果使用這個值,請一併加入character
屬性來識別圖片中的特定字元。如果有多個字元 (例如在投放中),請提供多個character
屬性做為陣列。logo
:圖片只包含標誌。可以是圖形標誌或標題標誌。使用對應的疊加層指定對應項目。
有效的類型只能使用其中一種。
建議用途
poster
:節目的海報圖片。在電腦 UI 中,可用於輪轉介面。但不一定會包含節目名稱。background
:適合使用文字或 UI 疊加層的背景圖片。這些圖片沒有文字。
為獲得最佳成效,請只加入下列其中一個建議用途。
大小合適度
smallFormat
:適合手機等小螢幕的圖片。圖片中的任何文字或標誌都清晰易讀。largeFormat
:適合大螢幕或紙本海報的圖片。
圖片可以同時使用這兩種值。
背景合適度
forDarkBackground
:圖片通常為透明標誌,適合用於深色背景。forLightBackground
:圖片通常為透明標誌,適用於淺色背景。
使用至少一個背景合適度值時,設定的值有效。
重疊說明
hasTitle
:節目的標題,或是圖片中包含的人物或演員名稱。請務必為圖片加入inLanguage
屬性。noTitle
:圖片不含標題。hasLogo
:圖片包含電影或電視節目的內容擁有者、內容擁有者或發布商。noLogo
:圖片不含標誌。hasCopyright
:圖片包含可見的版權聲明。noCopyright
:圖片不含可見的版權聲明。Google 通常不會在未經修改的情況下使用這類圖片。hasMatte
:圖片有霧面。選項可能是橫向 (上下黑邊)、垂直 (垂直黑邊) 或兩者 (上下黑邊)。有時候圖片會配合長寬比調整。Google 通常不會在未經修改的情況下使用這類圖片。noMatte
:圖片沒有霧面。transparentBackground
:圖片背景透明。這通常只適用於只有標題或標誌的圖片,未包含其他內容。
如要生效,您只能使用一個標題、一個標誌、1 個版權和 1 個屬性。
孕婦位置
centered
:主要數字位於圖片的中心。rightCentered
:主要面積位於圖片右側,因此文字和 UI 疊加層的左側相對空白。leftCentered
:主要圖形位於圖片左側,因此文字和 UI 疊加層的右側相對空白。
如要生效,請加入下列其中一個位置。
範例用途
圖片及其 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"]
}
]
}
}
電視影集背景圖片僅限於兩個區域
{
"@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"]
}
]
}]
}