圖片屬性

本節針對電影和電視節目提供 image 的內容標記屬性。這個標記可讓提供者描述圖片類型，例如標題、背景或代表性圖片，以及建議用途。

規格表

可以為 Movie、TVSeries、TVSeason 或 TVEpisode 實體類型提供 image 屬性。下表說明 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 地點 建議做法 - 允許映像檔的區域。如未指定，系統會假設圖片可以在所有位置使用。請使用 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 疊加層的右側相對空白。

如要生效，請加入下列其中一個位置。

範例用途

電視 UI，顯示背景圖片和 UI 重疊的背景圖片。
在電視 UI 中顯示輪轉介面，且背景圖片上的圖片圖片。
內含代表海報圖片和背景 iconic 圖片的行動 UI。
內含代表海報圖片和背景 sceneStill 圖片的行動 UI。

圖片及其 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、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"]
      }
    ]
  }
}

電視影集背景圖片僅限於兩個區域

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