このセクションでは、映画やテレビ番組の image
のコンテンツ マークアップ プロパティについて詳しく説明します。このマークアップにより、プロバイダは画像のタイプ(タイトル、背景、象徴的な画像など)と、その推奨される使い方を説明することができます。
仕様表
image
プロパティは、Movie
、TVSeries
、TVSeason
、または TVEpisode
エンティティ タイプとして指定できます。image
プロパティで使用可能なプロパティを次の表に示します。プロパティ additionalProperty
には、contentAttributes
というカスタム プロパティ名が含まれています。ここには、画像の種類とその用途を説明する値の配列が格納されます。
プロパティ | タイプ | 説明 |
---|---|---|
@context |
テキスト | 必須 - 常に "http://schema.org" に設定されます。 |
@type |
テキスト | 必須 - 常に ImageObject に設定されます。 |
contentUrl |
URL | 必須 - 画像の URL。 |
additionalProperty |
PropertyValue | 必須 - プロパティ contentAttributes で、画像の種類とその用途を記述します。詳しくは、contentAttributes をご覧ください。 |
character |
担当者 |
必須(該当する場合)- 画像に関連付けられた架空の文字。 |
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 つまで含めてください。
用途別の画像の例
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-1.png?authuser=0&hl=ja)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-2.png?authuser=0&hl=ja)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-3.png?authuser=0&hl=ja)
iconic
画像を使用したモバイル UI![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-4.png?authuser=0&hl=ja)
sceneStill
画像を使用したモバイル UIサンプル画像とその contentAttributes
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-5.png?authuser=0&hl=ja)
contentAttributes: ["iconic", "poster", "centered",
"hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-6.png?authuser=0&hl=ja)
contentAttributes: ["iconic", "background", "centered",
"smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright",
"noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-7.png?authuser=0&hl=ja)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=0&hl=ja)
contentAttributes: ["iconic", "background",
"rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-9.png?authuser=0&hl=ja)
contentAttributes: ["iconic", "poster", "smallFormat",
"largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-10.png?authuser=0&hl=ja)
contentAttributes: ["iconic", "poster", "largeFormat",
"hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-11.png?authuser=0&hl=ja)
contentAttributes: ["castInCharacter", "hasTitle",
"hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character:
{name: "Captain Pulsar"}
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-12.png?authuser=0&hl=ja)
contentAttributes: ["logo", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-13.png?authuser=0&hl=ja)
contentAttributes: ["logo", "hasTitle", "hasLogo"
"noCopyright", "noMatte", "centered", "transparentBackground",
"forLightBackground", "forDarkBackground", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-14.png?authuser=0&hl=ja)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"hasCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-15.png?authuser=0&hl=ja)
contentAttributes: ["iconic", "poster", "centered",
"noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-16.png?authuser=0&hl=ja)
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 ) |
800X600 | |||||
1 対 1、iconic poster |
600×600 | |||||
3:4、 |
600×800 | |||||
16:9、 |
3840×2160 | |||||
2:3、 |
1000×1500 | |||||
3:4、 |
600×800 | |||||
1:1、ロゴを表示(hasLogo ) |
600×600 | |||||
4:3、チャンネルのロゴ(logo ) |
800X600 | |||||
1:1、チャンネルのロゴ(logo ) |
600×600 | |||||
16:9、チャンネル ロゴ(logo ) |
3840×2160 | |||||
9:5、 |
1800x1000 |
画像を送信するときは、次のガイドラインが適用されます。
- 画像の形式は、JPEG、PNG、WebP のいずれかである必要があります。
- 最高解像度の画像を含める。
- ファイルサイズは 20 MB を超えないようにしてください。
centered
枚の画像が推奨されます。rightCentered
とleftCentered
の背景画像は一部のサービスでも使用できるため、必要に応じて追加できます。smallFormat
とlargeFormat
の両方で機能するイメージをおすすめします。- 前の表に記載されているサイズに加えて、画像サイズも指定できます。
- 各画像のアスペクト比が、上記の表に記載されている共通の値のいずれかであることを確認します。それ以外の場合は、警告が出されます。
スキーマ付きイメージの例
次の例は、映画やテレビ番組に関連付けられた画像のスキーマをフォーマットする方法を示しています。
2 文字の映画の背景画像
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=0&hl=ja)
{
"@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 つのリージョンに制限されています
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=0&hl=ja)
{
"@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 つの地域向けの映画ポスター画像
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-9.png?authuser=0&hl=ja)
{
"@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"]
}
]
}
}
大判のポスター(韓国語と英語の両方)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-17.png?authuser=0&hl=ja)
{
"@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"]
}
]
}]
}