画像プロパティ

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

仕様表

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

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

必須（該当する場合）- 画像に関連付けられた架空の文字。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 行政区域 推奨 - このイメージの対象リージョンまたは優先リージョン。 一方、regionsAllowed を使用してハード制限を指定します。audience.geographicArea が指定されていない場合、すべての場所での使用を想定しているものとみなされます。国は ISO 3166 形式で指定します。
copyrightHolder Organization または Person 推奨 - 画像の著作権を保有する当事者。
keywords テキスト 推奨 - この画像の説明に使用されるキーワードまたはタグ。配列を使用して複数の keywords を指定できます。例: ["feature, biography"]
name テキスト 推奨 - イメージの名前。

contentAttributes

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

タイプ

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

有効にするには、これらのうちいずれか一方のみを使用してください。

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

推奨される使い方は以下のとおりです。

サイズの適合性

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

  • largeFormat: 大きな画面やポスターの印刷に適した画像です。

1 つの画像で両方の値を使用できます。

背景の適合性

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

妥当性を維持するには、背景の適合性値を 1 つまで使用します。

オーバーレイ

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

有効期間には、1 つのタイトル、1 つのロゴ、1 つの著作権、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 1000×1500
4:3（iconic poster） 800Ｘ600
1 対 1、iconic poster 600×600

3:4、iconic poster

 600×800

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

 3840×2160

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

 1000×1500

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

 600×800
1:1、ロゴを表示（hasLogo） 600×600
4:3、チャンネルのロゴ（logo） 800Ｘ600
1:1、チャンネルのロゴ（logo） 600×600
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"]
        }
      ]
    }]
}