画像プロパティ

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

仕様表

image プロパティは、Movie、TVSeries、TVSeason、TVEpisode、SportsEvent、BroadcastEvent のエンティティ タイプに指定できます。次の表に、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 形式、タイムゾーンを含む）。

  • 将来の日付も設定できます。

画像の使用に時間ベースの制限がある場合、指定された日付より前に画像を表示してはならない場合は、このプロパティが必要です。このような制限がない場合は、省略できます。対応する画像は、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: 画像にロゴのみが含まれている。これは、グラフィック ロゴまたはタイトルロゴのいずれかです。対応するオーバーレイを追加して、どちらかを指定します。

有効にするには、これらのタイプのいずれか 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 オーバーレイを含む背景画像を表示する TV UI。
背景画像にポスター画像を含むカルーセルを表示する TV 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 1000x1500
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

 1000x1500

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