画像プロパティ

このセクションでは、映画とテレビ用の 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 規格。 画像に次の contentAttribute が含まれている場合: hasTitle。このプロパティは必須です。
regionsAllowed Place 推奨 - イメージが許可されているリージョン。回答が「いいえ」の場合 すべての場所で画像の使用が許可されていると見なされます。 国を ISO 3166 形式。
datePublished 日付

必須（該当する場合） - この日以降に画像が使用可能になる日付 ISO 8601 形式（タイムゾーンを含む）。

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

画像の使用に時間ベースの制限がある場合、このプロパティには 指定された日付より前に画像を表示する必要がない場合は必須。「いいえ」の場合: 省略できます。対応するイメージは nginx ウェブサーバーに datePublished の 7 日前までにフィードで提供されている。これにより、 コンテンツが時間どおりに Google の各種サービスに表示される可能性が高まる。

expires 日付

必須（該当する場合） - 画像が使用できなくなる日付。 ISO 言語 8601 形式（タイムゾーンを含む）。

  • 公開後にコンテンツが常に利用できる場合は、このオプションを省略できます。 プロパティです。

有効期限の更新は、少なくともフィードで行う必要があります。 有効期限の 7 日前。これにより、コンテンツが停止される可能性が 有効期限に Google サーフェスに表示されます。

audience 対象 推奨 - 対象ユーザー、または対象ユーザー 説明します。
audience.geographicArea AdministrativeArea 推奨 - このイメージに想定されている、または優先されるリージョン。 ハードコードを指定するには、regionsAllowed を使用します。 あります。audience.geographicArea が指定されていない場合、 あらゆる場所での使用が想定されています具体的な 国の数 ISO 3166 形式。
copyrightHolder Organization（組織） または Person 推奨 - コンテンツの著作権を所有する当事者 説明します。
keywords テキスト 推奨 - この画像を説明するために使用するキーワードまたはタグ。 配列を使用して複数の keywords を指定できます。例: ["特集、経歴"]
name テキスト 推奨 - イメージの名前。

contentAttributes

image の contentAttributes プロパティは、イメージのタイプと 推奨する用途を定義します。次のリストのカテゴリには、 プロバイダが各 ImageObject に含める必要がある contentAttributes 値。

タイプ

  • iconic: 番組の説明画像。多くの場合、芸術家は 説明します。
  • sceneStill: 番組からの画像の抜粋。
  • castInCharacter: 登場人物の写真。条件 使用する場合は、 <ph type="x-smartling-placeholder"></ph> character プロパティを使用して、 説明します。キャスト アンサンブルのように複数のキャラクターが存在する場合は、 複数の character プロパティを配列として格納できます。
  • logo: 画像にはロゴのみが含まれています。グラフィック形式のロゴか、 追加できます指定するには、対応するオーバーレイを含めます。

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

  • poster: 番組のポスター画像。パソコンの UI では、これらの変数を 。番組のタイトルが含まれているとは限りません。
  • background: テキストや UI の背景として使うのに適した画像 オーバーレイします。これらの画像にはテキストが含まれていません。

有効と見なされるには、以下の推奨される使用方法を 1 つだけ含めてください。

サイズの適合性

  • smallFormat: モバイルなどの小さな画面に適した画像 対応しています。画像内のテキストやロゴは、小さな画面でも判読できます。

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

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

背景の適合性

  • forDarkBackground: 画像（通常は透明なロゴ） 暗い背景で使用できます
  • forLightBackground: 画像（通常は透明なロゴ） 背景として使用してください

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

オーバーレイ

  • hasTitle: 番組のタイトル、キャラクターや俳優の名前 渡されます。イベントには必ず inLanguage プロパティを含めて、 説明します。
  • noTitle: 画像にタイトルは含まれません。
  • hasLogo: 画像に映画や番組のロゴ、コンテンツ所有者、 提供します
  • noLogo: 画像にロゴが含まれていません。
  • hasCopyright: 画像に著作権に関する通知が画面に表示されている。
  • noCopyright: 画像に著作権に関する通知が見えない。Google 一般的に、そのような画像を修正せずに使用することはできません。
  • hasMatte: 画像にマットが入っています。横向き（レターボックス）や、 縦方向（ピラーボックス）、またはその両方（ウィンドウボックス）で表示されます。画像は、サイズに合わせてマット加工されることがあります。 変換する必要があります通常、Google は、こうした画像を使用しない限り、 あります。
  • noMatte: 画像にマットが適用されていません。
  • transparentBackground: 画像の背景は透明です。これは、 通常、タイトルやロゴのみの画像に使用します。

有効にするには、タイトル、ロゴ、著作権、マット属性をそれぞれ 1 つだけ指定します 使用できます。

主な人物の位置

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

有効と見なされるには、これらの掲載位置を 1 つだけ指定してください。

画像の例と使用目的

<ph type="x-smartling-placeholder">
</ph>
テキストと UI のオーバーレイを含む背景画像を表示する TV UI。
で確認できます。
<ph type="x-smartling-placeholder">
</ph>
ポスター画像を背景にカルーセルを表示する TV UI 画像。
で確認できます。 <ph type="x-smartling-placeholder">
</ph>
ポスター画像と背景が表示されたモバイル UI iconic イメージ。
で確認できます。 <ph type="x-smartling-placeholder">
</ph>
ポスター画像と背景が表示されたモバイル UI sceneStill イメージ。

画像とその 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 のサービスやサーフェスが異なれば、 画像タイプとアスペクト比コンテンツが 正しく表示されるよう、プロバイダは イメージタイプを見ていきましょう。

アスペクト比と 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

 600×800

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

 3840×2160

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

 1,000 x 1,500

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

 600×800
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"]
        }
      ]
    }]
}