このページは Cloud Translation API によって翻訳されました。

画像プロパティ

このセクションでは、映画とテレビ番組の 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` が含まれている場合は必須です。注: キャラクターが人間でない場合でも、ここでは `Person` タイプを使用できます。
`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 つだけ含める必要があります。

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

画像の例とその 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

画像を送信する際は、次のガイドラインに従ってください。

画像は JPEG、PNG、WebP 形式である必要があります。
可能な限り解像度の高い画像を含めます。
ファイルサイズは 20 MB 以下である必要があります。
centered 画像をおすすめします。rightCentered と leftCentered の背景画像は一部のプロダクトでも使用できるため、画像がある場合は含めることができます。
smallFormat と largeFormat の両方で使用できる画像をおすすめします。
上記の表に記載されているサイズに加えて、画像サイズを追加できます。
各画像のアスペクト比が、上の表に記載されている一般的な値のいずれかであることを確認します。それ以外の場合は、警告が表示されます。

スキーマを含む画像の例

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

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