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

このセクションでは、 メディア アクションの構成をキャプチャする MediaService エンティティ タイプ 統合

<ph type="x-smartling-placeholder">

仕様表

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

必須 - 常に MediaService に設定します。

@context テキスト

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

@id URL

必須 - ブランドの一意の識別子。たとえば https://example.com

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

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

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

ブランドにロケール固有の名前がある場合は、配列としてリストします。たとえば MediaService の例をご覧ください。

brandIcon ImageObject

すべてのウォッチ アクションとリッスン アクションで必須 - ブランドの画像ファイル サイズごとに繰り返しアイコンが 表示されます視聴アクションの結果では、ユーザーの ブランド アイコンへのコンテンツのディープリンクを設定します。

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

  • PNG ファイルです。
  • 背景は透明です。
  • その形状は丸く、自然です。
  • 画像がアンチエイリアスで、歪んだりモザイク状になったりしないようにしてください。

このプロパティは繰り返す必要があります。なぜなら、 次のディメンションです

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

Google TV との統合に関する追加要件 - ブランドを表す画像 アイコンが、プログラミング ガイドの上部にある [Watch Action] ボタンと 。次の要件を満たすアイコンを 3 つ用意してください。

  • PNG ファイル形式の正方形のアイコン 1 つ。(解像度 512 x 512 ピクセル、アスペクト比 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、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: Google Play ストアの Android パッケージ名。例: com.abc.media.android
  • キャスト: キャストアプリの ID。例: ACDA4FDE
  • AndroidTV: Google Play ストアの AndroidTV パッケージ名。例: com.abc.media.atv.android
parentOrganization Organization(組織)

必須 - サービスの親プロバイダ。

parentOrganization.@type テキスト

必須 - 常に Organization に設定します。

parentOrganization.name テキスト

必須 - 組織名。

subscriptions MediaSubscription

省略可 - 使用可能な MediaSubscriptions のリスト スマートウォッチのプロバイダによってサポートされている

baseSubscriptionTier MediaSubscription

該当する場合は必須 - スマートウォッチのプロバイダとプロバイダにベースがある場合 利用できるコンテンツについては、定期購入パッケージを定期購入インスタンスに設定する必要があります。 すべての購読者に配信しますそれ以外の場合、このプロパティは必須ではありません。

userRequestsFulfilledBy テキスト

省略可 - ユーザーを満たす以下のいずれかの当事者に設定します リクエスト:

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

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

mediaOffered テキスト

必須 - 次のいずれかに設定します。これは、 カタログに含まれる情報をすべて抽出できます

で確認できます。 <ph type="x-smartling-placeholder">

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