圖片屬性

本節將詳細說明電影和電視節目的 image 內容標記屬性。這項標記可讓供應商說明圖片類型 (例如標題、背景或圖示圖片)，以及建議用途。

規格表

image 屬性可用於 Movie、TVSeries、TVSeason 或 TVEpisode 實體類型。下表說明 image 屬性可用的屬性。請注意，屬性 additionalProperty 包含名為 contentAttributes 的自訂屬性名稱，該名稱會保留值陣列，說明圖片類型及其預期用途。

屬性 預期類型 說明
@context Text 必要：一律設為 "http://schema.org"。
@type Text 必要：一律設為 ImageObject。
contentUrl 網址 必填：圖片的網址。
additionalProperty PropertyValue 必要：定義屬性 contentAttributes，描述圖片類型及其用途。詳情請參閱 contentAttributes。
character Person

如適用，則為必填：與圖片相關的虛構人物。如果 contentAttribute 包含 castInCharacter，則必須使用此屬性。
inLanguage Text 必要 (如適用)：圖片中使用的文字語言。請使用 IETF BCP 47 標準的其中一個語言代碼。如果圖片包含 hasTitle 的 contentAttribute，就必須使用這個屬性。
regionsAllowed Place 建議：允許使用圖片的區域。如果未指定，系統會假設任何地方的使用者都可以瀏覽這張圖片。請採用 ISO 3166 格式來指定國家/地區。
datePublished 日期

如適用，則為必要屬性：圖片到期日，採用 ISO 8601 格式 (包括時區)。

  • 日期可以設為未來的日期。

如果圖片的使用方式有時間限制，且圖片不得在指定日期前顯示，則必須使用這個屬性。如果沒有這類限制，則可省略。請務必在發布日期至少 7 天前，在動態饋給中提供對應的圖片。這樣一來，內容就更有機會按時顯示在 Google 服務中。
expires 日期

如適用，則為必要屬性：圖片到期日，採用 ISO 8601 格式 (包括時區)。

  • 如果內容在發布後一律可供使用，您可以省略這個屬性。

請務必在到期日至少 7 天前，在動態饋給中更新到期日。這樣一來，內容就更有可能在到期日當天停止顯示在 Google 途徑上。
audience 觀眾 建議：這張圖片的目標或偏好目標對象。
audience.geographicArea AdministrativeArea 建議：這張圖片的預期或偏好區域。 相反地，請使用 regionsAllowed 指定硬性限制。如果未指定 audience.geographicArea，則系統會假設該影片可供所有人觀看。請採用 ISO 3166 格式來指定國家/地區。
copyrightHolder 機構或人員 建議：擁有圖片版權的一方。
keywords Text 建議：用來描述這張圖片的關鍵字或標記。 您可以使用陣列提供多個 keywords。例如：["feature, biography"]
name Text Recommended：映像檔的名稱。

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 重疊圖層。

最多只能包含其中一個位置。

圖片示例及其預期用途

TV 使用者介面，顯示背景圖片，並疊加文字和 UI。
TV 應用程式介面，可在背景圖片上顯示輪轉介面和海報圖片。
行動版 UI，包含海報圖片和背景 iconic 圖片。
行動版 UI，內含海報圖片和背景 sceneStill 圖片。

圖片範例及其內容屬性

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 產品上正確顯示，我們要求供應商提供下表中的所有圖片類型。

顯示比例和內容屬性 最低解析度 (像素) 電影 電視影集 電視節目季別 電視劇集 無線電視服務
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"]
      }
    ]
  }
}

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