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

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

このセクションでは、メディア アクションの統合の構成を取得する MediaService エンティティ タイプのコンテンツ マークアップ プロパティの詳細について説明します。

仕様表

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

必須 - 常に MediaService に設定されます。

@context テキスト

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

@id URL

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

識別子は次の要件を満たす必要があります。

  • これは、カタログ全体でグローバルに一意です。
  • 静的です。ID は変わらず安定している必要があります。
  • URI(Unified Resource Identifier)形式です。
  • 組織のドメインが所有している必要があります。
name テキスト

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

ブランドに地域別の名前がある場合は、その名前を配列にまとめます。例については、MediaService の例をご覧ください。

brandIcon ImageObject

すべての Watch Actions と Listen Actions に必須 - ブランドアイコンの画像ファイル。サイズごとに繰り返し表示されます。Watch/Listen アクションの結果では、コンテンツのディープリンクとブランド アイコンが関連付けられます。

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

  • PNG ファイルです。
  • 背景は透明です。
  • その性質は円形です。
  • 画像のエイリアスにエイリアスが設定され、画像が歪んだりモザイク状になったりしていないことを確認する

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

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

Google TV の統合に関する追加要件 - このブランドアイコンの画像は、プログラミング ガイドの上部、Watch Action ボタン、Google TV 設定に表示されます。次の要件を満たす 3 つのアイコンを用意します。

  • PNG 形式の 1 つの正方形のアイコン。(解像度 512x512 ピクセル、アスペクト比 1:1)
  • PNG ファイル形式の 1 つの白い文字商標アイコン。(最高解像度、アスペクト比は特に重視しない)
  • PNG ファイル形式の 1 つの色付き文字アイコン。(最高解像度、アスペクト比は特に重視しない)

画像のエイリアスがエイリアスとして設定され、歪んだりモザイク状になったりしないようにしてください。

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、または Android TV のアプリを提供する場合に必須 - ブランド アプリケーションのリストを以下に記載します。

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

必須 - 常に SoftwareApplication に設定されます。

application.operatingSystem テキスト

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

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

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

その他のプラットフォームの場合、これは必須プロパティではありません。

application.installURL URL

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

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

application.identifier

Text

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

  • iOS: App Store アプリ識別子。例: 967093455
  • Android: Play ストアの Android パッケージ名。例: com.abc.media.android
  • キャスト: キャストアプリ ID。例: ACDA4FDE
  • AndroidTV: Play ストアの Android TV パッケージ名。例: 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"
      }
    }
  ]
}