画像プロパティ

このセクションでは、映画とテレビ用の 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

imagecontentAttributes プロパティは、イメージのタイプと 推奨する用途を定義します。次のリストのカテゴリには、 プロバイダが各 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 800X600
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 800X600
1:1、チャンネルのロゴ(logo 600x600
16:9、チャンネルロゴ(logo 3840×2160

9:5、hasTitle logotransparentBackground と両方 forLightBackgroundforDarkBackground

1800x1000

画像を登録するときは、次のガイドラインが適用されます。

  1. 画像は JPEG、PNG、WebP のいずれかの形式である必要があります。
  2. 可能な限り解像度の高い画像を用意する。
  3. ファイルサイズは 20 MB を超えないようにしてください。
  4. centered 枚の画像が推奨されます。rightCentered および leftCentered 一部のプロダクトでは背景画像も使用できるため、それらを含めることができます。 存在する場合があります
  5. smallFormatlargeFormat の両方で機能する画像をおすすめします。
  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"]
        }
      ]
    }]
}