画像プロパティ

このセクションでは、映画とテレビ番組の image のコンテンツ マークアップ プロパティについて詳しく説明します。このマークアップにより、プロバイダは画像の種類（タイトル、背景、アイコン画像など）と推奨される用途を記述できます。

仕様表

image プロパティは、Movie、TVSeries、TVSeason、TVEpisode エンティティ タイプに指定できます。次の表に、image プロパティで使用可能なプロパティを示します。プロパティ additionalProperty には、contentAttributes というカスタム プロパティ名が含まれています。このプロパティには、画像の種類とその用途を表す値の配列が保持されます。

プロパティ タイプ 説明
@context テキスト 必須 - 常に "http://schema.org" に設定します。
@type テキスト 必須 - 常に ImageObject に設定します。
contentUrl URL 必須 - 画像の URL。
additionalProperty PropertyValue 必須 - 画像の種類とその用途を記述するプロパティ contentAttributes を定義します。詳しくは、contentAttributes をご覧ください。
character Person

該当する場合は必須 - 画像に関連付けられた架空のキャラクター。contentAttribute に castInCharacter が含まれている場合は必須です。
inLanguage テキスト 該当する場合は必須 - 画像で使用されているテキストの言語。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 Organization または Person 推奨 - 画像の著作権を所有する当事者。
keywords テキスト 推奨 - この画像の説明に使用されるキーワードまたはタグ。 配列を使用して複数の keywords を指定できます。例: ["feature, biography"]
name テキスト 推奨 - 画像の名前。

contentAttributes

image の contentAttributes プロパティは、画像のタイプを記述し、推奨される用途を定義します。次のリストのカテゴリには、プロバイダが各 ImageObject に含める必要がある contentAttributes 値が含まれています。

タイプ

  • iconic: 番組を代表する画像。多くの場合、芸術的なレンダリングです。
  • sceneStill: 番組の抜粋画像。
  • castInCharacter: キャラクターに扮したキャストの写真。この値を使用する場合は、 character プロパティも含めて、画像内の特定の文字を識別します。キャスト アンサンブルなど、複数のキャラクターがある場合は、複数の character プロパティを配列として含めます。
  • logo: 画像にロゴのみが含まれています。グラフィック ロゴまたはタイトルロゴのいずれかになります。対応するオーバーレイを含めて、どのオーバーレイを使用するかを指定します。

有効にするには、これらのタイプのいずれか 1 つだけを使用します。

  • poster: 番組のポスター画像。パソコンの UI では、カルーセルで使用できます。番組のタイトルが含まれる場合と含まれない場合があります。
  • background: テキストや UI のオーバーレイがある背景として使用できる画像。これらの画像にはテキストが含まれていません。

有効にするには、推奨される用途を 1 つだけ含めます。

サイズの適合性

  • smallFormat: スマートフォンなどの小画面に適した画像。画像内のテキストやロゴが小さい画面でも判読できる。

  • largeFormat: 大画面や印刷されたポスターに適した画像。

画像では、これらの値の両方を使用できます。

背景の適合性

  • forDarkBackground: 暗い背景に使用できる画像（通常は透明なロゴ）。
  • forLightBackground: 明るい背景に使用できる画像（通常は透明なロゴ）。

有効にするには、背景の適合性値を 1 つだけ使用してください。

オーバーレイ

  • hasTitle: 番組のタイトル、または画像に含まれるキャラクターまたは俳優の名前。画像の inLanguage プロパティを含める必要があります。
  • noTitle: 画像にタイトルが含まれていません。
  • hasLogo: 映画や番組のロゴ、コンテンツ所有者、配信会社のロゴが含まれている画像。
  • noLogo: 画像にロゴが含まれていません。
  • hasCopyright: 画像に著作権に関する通知が含まれている。
  • noCopyright: 画像に著作権に関する通知が含まれていません。通常、Google はそのような画像を変更なしで使用できません。
  • hasMatte: 画像にマットがあります。横向き（レターボックス）、縦向き（ピラーボックス）、またはその両方（ウィンドウボックス）にできます。画像がアスペクト比に合わせてマット処理されることがあります。通常、Google はそのような画像を変更せずに使用することはできません。
  • noMatte: 画像にマットがありません。
  • transparentBackground: 画像の背景は透明です。通常、タイトルやロゴのみの画像に使用されます。

有効にするには、タイトル、ロゴ、著作権、マットの属性を 1 つずつ指定する必要があります。

主な人物のポジション

  • centered: 主な人物は画像の中央に配置されます。
  • rightCentered: 主な人物は画像の右側に配置され、左側はテキストと UI のオーバーレイ用に比較的空白になります。
  • leftCentered: 主な人物は画像の左側に配置され、右側はテキストと UI のオーバーレイ用に比較的空白になります。

有効にするには、これらの位置を 1 つだけ含める必要があります。

画像の使用目的が記載されたサンプル画像

テキストと 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 3840×2160
2:3、iconic poster 1,000 x 1,500
4:3、iconic poster 800Ｘ600
1:1、iconic poster 600x600

3:4、iconic poster

 600x800

16:9、iconic background [推奨]、または sceneStill

 3840×2160

2:3、iconic background [推奨]、または sceneStill

 1,000 x 1,500

3:4、iconic background [推奨]、または sceneStill

 600x800
1:1、ロゴを表示（hasLogo） 600x600
4:3、チャンネル ロゴ（logo） 800Ｘ600
1:1、チャンネル ロゴ（logo） 600x600
16:9、チャンネル ロゴ（logo） 3840×2160

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. 各画像のアスペクト比が、上の表に記載されている一般的な値のいずれかであることを確認します。それ以外の場合は、警告が表示されます。

スキーマを含む画像の例

次の例は、映画やテレビ番組に関連付けられた画像のスキーマをフォーマットする方法を示しています。

2 人のキャラクターが写っている映画の背景画像

{
  "@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 の背景画像が 2 つの地域に制限されている

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

2 つの地域を対象とした映画ポスター画像

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