MediaService のコンテンツ マークアップ プロパティ（必須）

このセクションでは、Media Action 統合の構成をキャプチャする MediaService エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。

仕様表

プロパティ タイプ 説明
@type テキスト

必須 - 常に MediaService に設定します。
@context テキスト

必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定します。
@id URL

必須 - ブランドの一意の識別子（例: https://example.com）。

ID は次の要件を満たしている必要があります。

  • カタログ全体でグローバルに一意です。
  • 静的です。ID は固定されており、時間の経過とともに変化してはなりません。
  • Unified Resource Identifier（URI）形式です。
  • ドメインは組織が所有している必要があります。
name テキスト

必須 - プロバイダの名前。

ブランドに言語 / 地域固有の名前がある場合は、配列にリストします。例については、MediaService の例をご覧ください。
brandIcon ImageObject

すべてのウォッチ アクションとリスニング アクションで必須 - ブランド アイコンの画像ファイル（サイズごとに複数）。動画再生/音楽再生アクションの結果で、コンテンツのディープリンクがブランド アイコンに関連付けられます。

ブランド アイコンの画像ファイルは、次の要件を満たしている必要があります。

  • PNG ファイルです。
  • 背景は透明です。
  • 形状は丸い。
  • 画像がアンチエイリアス処理されており、歪みやモザイク化がないことを確認する

このプロパティは繰り返す必要があります。次のディメンションごとに 1 つずつ、5 つの画像を指定する必要があります。

  • 16 x 16 ピクセル、ファイルサイズ 1 KB 以下
  • 20 x 20 ピクセル、ファイルサイズ 1 KB 以下
  • 40 x 40 ピクセル、ファイルサイズ 1 KB 以下
  • 44 x 44 ピクセル、ファイルサイズ 1 KB 以下
  • 112 x 112 ピクセル、ファイルサイズ 3 KB 以下

Google TV との統合に関する追加要件 - ブランドアイコンの画像は、番組ガイドの上部、視聴アクション ボタン、Google TV の設定に表示されます。次の要件を満たす 3 つのアイコンを指定します。

  • PNG ファイル形式の正方形のアイコン 1 つ。（解像度 512x512 ピクセル、アスペクト比 1:1）
  • 1 つの白い文字商標アイコン（PNG ファイル形式）。（使用可能な最大解像度、アスペクト比の指定なし）
  • 1 つのカラー文字商標アイコン（PNG ファイル形式）。（使用可能な最大解像度、アスペクト比の指定なし）

画像がアンチエイリアス処理されており、歪みやモザイク化がないことを確認します。

brandIcon.contentURL URL

必須 - 画像の URL。
brandIcon.height 番号

必須 - 画像の高さ（ピクセル単位）。
brandIcon.width 番号

必須 - 画像の幅（ピクセル単位）。
brandIcon.additionalProperty PropertyValue

必須 - イメージのタイプを記述するために使用される追加プロパティで、想定される用途を定義します。
brandIcon.additionalProperty.@type テキスト

必須 - PropertyValue に設定します。
brandIcon.additionalProperty.name テキスト

必須 - contentAttributes に設定します。
brandIcon.additionalProperty.value テキスト

必須 - 背景の適合性。

有効にするには、次のいずれかの値を 1 つ以上設定します。

  • forDarkBackground: 暗い背景で使用できる画像（通常は透明なアイコン）。
  • forLightBackground: 明るい背景での使用に適した画像（通常は透明なアイコン）。
application SotfwareApplication

iOS、Android、Cast、AndroidTV のアプリが提供されている場合必須 - 以下のブランドアプリのリスト:

  • iOS
  • Android
  • キャスト
  • AndroidTV
application.@type テキスト

必須 - 常に SoftwareApplication に設定します。
application.operatingSystem テキスト

必須 - 次のいずれかに設定します。

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadUrl URL

該当する場合は必須 - Android、AndroidTV、iOS の各プラットフォームでは、App Store と Google Play ストア内のアプリへのリンクとして指定する必要があります。

他のすべてのプラットフォームでは、このプロパティは必須ではありません。
application.installUrl URL

該当する場合は必須 - プロバイダが AndroidTV アプリを介してメディア再生を提供している場合は、AndroidTV APK ファイルへのリンクとして指定する必要があります。

プロバイダが AndroidTV での再生を提供しない場合、このプロパティは必須ではありません。
application.identifier

テキスト

必須（該当する場合） - 次のいずれかの値に対応するプラットフォームの場合は、それに応じて設定します。それ以外の場合、このプロパティは必須ではありません。

  • iOS: App Store アプリの ID。例: 967093455
  • Android: Play ストアの Android パッケージ名。例: com.abc.media.android
  • Cast: Cast アプリ ID。例: ACDA4FDE
  • AndroidTV: Play ストアの AndroidTV パッケージ名。例: com.abc.media.atv.android
parentOrganization 組織

必須 - サービスの親プロバイダ。
parentOrganization.@type テキスト

必須 - 常に Organization に設定します。
parentOrganization.name テキスト

必須 - 組織名。
subscriptions MediaSubscription

省略可 - スマートウォッチ プロバイダでサポートされている利用可能な MediaSubscriptions のリスト。
baseSubscriptionTier MediaSubscription

該当する場合は必須 - ウォッチ プロバイダとそのプロバイダにベース サブスクリプション パッケージがある場合は、すべての定期購入者に利用可能なコンテンツのサブスクリプション インスタンスに設定する必要があります。それ以外の場合、このプロパティは必須ではありません。
userRequestsFulfilledBy テキスト

省略可 - ユーザー リクエストを処理する次のいずれかの当事者に設定します。

  • Google: すべてのリクエストは Google によって処理されます。基本的に、Google はリクエストされたコンテンツのディープリンクを返します。
  • Provider: すべてのリクエストは、コンテンツ プロバイダ（クラウド プロバイダ）によって処理されます。基本的に、プロバイダはリクエストされたコンテンツのディープリンクを返すか、デバイスで直接再生を開始します。

デフォルトでは、このプロパティは Google に設定されています。
mediaOffered テキスト

必須 - フィードに含まれるカタログ内のコンテンツの種類に対応する次のいずれかに設定します。

  • ["VoD"] - プロバイダは、フィードにビデオ オンデマンド（VoD）コンテンツのみを含めます。VoD コンテンツには、映画やテレビ番組が含まれます。
  • ["LiveTV"] - プロバイダは、フィードにライブテレビのみを含めます。これには、チャンネルと BroadcastEvent コンテンツが含まれます。
  • ["VoD", "LiveTV"] - プロバイダがフィードに VoD とライブテレビの両方のコンテンツを含めています。
  • ["Music"] - プロバイダは、フィードに音楽エンティティのみを含めます。これには、アルバム、アーティスト、曲、再生リストのコンテンツが含まれます。
  • ["Radio"] - プロバイダは、フィードにラジオエンティティのみを含めます。
  • ["Music", "Radio"] - プロバイダがフィードに音楽とラジオのエンティティを含めます。これには、アルバム、アーティスト、曲、プレイリスト、ラジオ局のコンテンツが含まれます。

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"
      }
    }
  ]
}