ここでは、メディア アクションの統合の構成をキャプチャする、MediaService エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。
仕様表
| プロパティ | タイプ | 説明 |
|---|---|---|
@type
|
テキスト |
必須 - 常に |
@context
|
テキスト |
必須 - 常に |
@id
|
URL |
必須 - ブランドの一意の識別子（例: ID は次の要件を満たす必要があります。
|
name
|
テキスト |
必須 - プロバイダの名前。 ブランドにロケール固有の名前がある場合は、配列に列挙します。その例については、MediaService の例をご覧ください。 |
brandIcon
|
ImageObject |
すべてのウォッチ アクションとリッスン アクションに必須 - サイズごとに繰り返される、ブランド アイコンの画像ファイル。Watch/Listen アクションの結果では、コンテンツのディープリンクがブランド アイコンに関連付けられます。 ブランド アイコンの画像ファイルは、次の要件を満たしている必要があります。
次のディメンションごとに 1 つずつ、合計 5 つの画像を指定する必要があるため、このプロパティは繰り返す必要があります。
GoogleTV 統合の追加要件 - ブランド アイコンの画像は、番組ガイド ボタン、スマートウォッチ アクション ボタン、Google TV 設定に表示されます。次の要件を満たす 3 つのアイコンを用意します。
画像がアンチ エイリアス化され、歪みやモザイク状になっていないことを確認します。 |
brandIcon.contentURL
|
URL |
必須 - 画像の URL。 |
brandIcon.height
|
数値 |
必須 - 画像の高さ（ピクセル単位）。 |
brandIcon.width
|
数値 |
必須 - 画像の幅（ピクセル単位）。 |
brandIcon.additionalProperty
|
PropertyValue |
必須 - 画像の種類を示し、その用途を定義するために使用される追加のプロパティ。 |
brandIcon.additionalProperty.@type
|
テキスト |
必須 - |
brandIcon.additionalProperty.name
|
テキスト |
必須 - |
brandIcon.additionalProperty.value
|
テキスト |
必須 - 背景の適合性。 有効にするには、次の値のうち少なくとも 1 つに設定します。
|
application
|
SotfwareApplication |
iOS、Android、Cast、AndroidTV の各アプリで提供される場合は必須 - 以下のブランドアプリのリスト。
|
application.@type
|
テキスト |
必須 - 常に |
application.operatingSystem
|
テキスト |
必須 - 次のいずれかに設定します。
|
application.downloadUrl
|
URL |
必須 - Android、AndroidTV、iOS プラットフォームの場合、App Store と Play ストアでアプリへのリンクとして指定する必要があります。 他のすべてのプラットフォームでは、これは必須プロパティではありません。 |
application.installUrl
|
URL |
該当する場合に必須 - プロバイダが AndroidTV アプリを介してメディア再生を提供する場合は、これを AndroidTV APK ファイルへのリンクとして指定する必要があります。 プロバイダが AndroidTV 再生を提供していない場合、これは必須プロパティではありません。 |
application.identifier
|
該当する場合に必須 - 次のいずれかの値に対応するプラットフォームの場合は、適宜設定します。それ以外の場合、このプロパティは必須ではありません。
|
|
parentOrganization
|
組織 |
必須 - サービスの親プロバイダ。 |
parentOrganization.@type
|
テキスト |
必須 - 常に |
parentOrganization.name
|
テキスト |
必須 - 組織名。 |
subscriptions
|
MediaSubscription |
省略可 - スマートウォッチ プロバイダでサポートされている |
baseSubscriptionTier
|
MediaSubscription |
必要に応じて必須 - スマートウォッチ プロバイダとプロバイダに基本定期購入パッケージがある場合、すべての定期購入者が利用できるコンテンツの場合、これを定期購入インスタンスに設定する必要があります。それ以外の場合、このプロパティは不要です。 |
userRequestsFulfilledBy
|
テキスト |
省略可 - ユーザーのリクエストを満たす次のいずれかの当事者に設定します。
デフォルトでは、このプロパティは |
mediaOffered
|
テキスト |
必須 - フィードに含まれるカタログ コンテンツのタイプに対応する次のいずれかに設定します。
|
MediaService の例
{
"@context": "http://schema.org",
"@type": "DataFeed",
"dateModified": "2018-07-20T00:44:51Z",
"dataFeedElement": [
{
"@context": [
"http://schema.org",
{
"@language": "en"
}
],
"@type": "MediaService",
"@id": "https://abcmedia.com",
"name": [
{
"@language": "en-us",
"@value": "ABC Media"
},
{
"@language": "en-gb",
"@value": "ABC"
}
],
"userRequestsFulfilledBy": "Google",
"mediaOffered": [
"LiveTV",
"VoD"
],
"brandIcon": [
{
"@type": "ImageObject",
"contentURL": "https://abcmedia.com/path_to_logo_16x16.png",
"width": 16,
"height": 16,
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forDarkBackground",
"forLightBackground"
]
}
]
},
{
"@type": "ImageObject",
"contentURL": "https://abcmedia.com/path_to_logo_20x20.png",
"width": 20,
"height": 20,
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forDarkBackground",
"forLightBackground"
]
}
]
},
{
"@type": "ImageObject",
"contentURL": "https://abcmedia.com/path_to_logo_40x40.png",
"width": 40,
"height": 40,
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forDarkBackground",
"forLightBackground"
]
}
]
},
{
"@type": "ImageObject",
"contentURL": "https://abcmedia.com/path_to_logo_44x44.png",
"width": 44,
"height": 44,
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forDarkBackground",
"forLightBackground"
]
}
]
},
{
"@type": "ImageObject",
"contentURL": "https://abcmedia.com/path_to_logo_112x112.png",
"width": 112,
"height": 112,
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forDarkBackground",
"forLightBackground"
]
}
]
}
],
"application": [
{
"@type": "SoftwareApplication",
"operatingSystem": "Android",
"downloadUrl": "https://google.play.store/com.abc.media.android",
"identifier": "com.abc.media.android"
},
{
"@type": "SoftwareApplication",
"operatingSystem": "iOS",
"downloadUrl": "https://apple.app.store/967093455",
"identifier": "967093455"
},
{
"@type": "SoftwareApplication",
"operatingSystem": "AndroidTV",
"downloadUrl": "https://google.play.store/com.abc.media.atv.android",
"installUrl": "https://abcmedia.com/path_to_apkfile.apk",
"identifier": "com.abc.media.atv.android"
},
{
"@type": "SoftwareApplication",
"operatingSystem": "Cast",
"identifier": "ACDA4FDE"
}
],
"subscriptions": [
{
"@type": "MediaSubscription",
"name": "Basic Package",
"@id": "[partner determined string]",
"identifier": "abcmedia.com:basic"
},
{
"@type": "MediaSubscription",
"name": "Premium Package",
"@id": "[partner determined string]",
"identifier": "abcmedia.com:premium"
}
],
"baseSubscriptionTier": {
"@type": "MediaSubscription",
"name": "Basic Package",
"@id": "[partner determined string]",
"identifier": "abcmedia.com:basic"
},
"parentOrganization": {
"@type": "Organization",
"name": "ABC Media"
}
}
]
}