圖片屬性

本節詳細說明電影、電視節目、電視直播和體育賽事的 image 內容標記屬性。供應商可透過這項標記，說明圖片類型 (例如標題、背景或代表性圖片) 和建議用途。

規格表

image 屬性可提供給 Movie、TVSeries、TVSeason、TVEpisode、SportsEvent 或 BroadcastEvent 實體類型。下表說明 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 天前，在動態饋給中提供對應的圖片。這可提高內容準時顯示在 Google 平台上的機率。
expires 日期

視情況而定：圖片到期日，採用 ISO 8601 格式 (包括時區)。

  • 如果內容在發布後一律可供存取，則可省略這項屬性。

如要更新到期日，請務必在到期日前至少 7 天在動態饋給中完成。這可提高內容在到期日停止顯示在 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：節目的海報圖片。在電腦 UI 中，這些圖示可用於輪轉介面。這些圖片不一定會包含節目名稱。
  • background：適合做為背景的圖片，可疊加文字或 UI。這些圖片不含文字。

如要符合規定，請最多加入一項建議用途。

尺寸合適度

  • smallFormat：適合手機等小型螢幕的圖片。圖片中的任何文字或標誌在小螢幕上都清晰可辨。

  • largeFormat：適合較大螢幕或印刷海報的圖片。

圖片可以同時使用這兩個值。

背景合適度

  • forDarkBackground：適合在深色背景上使用的圖片，通常是透明標誌。
  • forLightBackground：通常是透明標誌，適合用於淺色背景。

如要確保有效，請最多使用一個背景適用性值。

重疊說明

  • hasTitle：節目名稱，或圖片中角色或演員的姓名。請務必加入圖片的 inLanguage 屬性。
  • noTitle：圖片不含標題。
  • hasLogo：圖片包含電影或節目、內容擁有者或發行商的標誌。
  • noLogo：圖片不含標誌。
  • hasCopyright：圖片包含可見的著作權聲明。
  • noCopyright：圖片未顯示著作權聲明。Google 通常無法在未經修改的情況下使用這類圖片。
  • hasMatte：圖片有遮罩。這可能是水平 (上下黑邊)、垂直 (左右黑邊) 或兩者皆有 (四周黑邊)。有時圖片會經過遮罩處理，以符合顯示比例。Google 通常無法直接使用這類圖片。
  • noMatte：圖片沒有襯紙。
  • transparentBackground：圖片背景為透明。這通常用於只有標題或標誌，沒有其他內容的圖片。

如要符合有效條件，只能有一個標題、一個標誌、一個版權和一個遮罩屬性。

主要人物的位置

  • centered：主要人物位於圖片中央。
  • rightCentered：主要人物位於圖片右側，左側相對空曠，可放置文字和 UI 疊加層。
  • leftCentered：主要人物位於圖片左側，右側相對空曠，可放置文字和 UI 疊加層。

如要確保有效，請最多加入其中一個位置。

圖片範例和預期用途

電視 UI 顯示背景圖片，並疊加文字和 UI。
電視 UI，在背景圖片上顯示含有海報圖片的輪轉介面。
含有海報圖片和背景圖片的行動裝置 UI。iconic
含有海報圖片和背景圖片的行動裝置 UI。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、iconicposter 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"]
        }
      ]
    }]
}