このページは Cloud Translation API によって翻訳されました。

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

このページの内容
仕様表
MediaService の例

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

キーポイント: MediaService エンティティは dataFeedElement 配列内に含める必要があります。下記の例をご覧ください。

キーポイント: すべての Media Actions フィード送信には、フィードに含まれるディープリンクプロバイダごとに 1 つの 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"
      }
    }
  ]
}

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

仕様表

MediaService の例

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