MediaService 的内容标记属性（必需）

本部分详细介绍了 MediaService 实体类型的内容标记属性，该实体类型用于捕获媒体操作集成的配置

规范表

属性 预期类型 说明
@type 文本

必需 - 始终设置为 MediaService。
@context 文本

必需 - 始终设置为 ["http://schema.org", {"@language": "xx"}]。
@id 网址

必需 - 品牌的唯一标识符；例如 https://example.com。

标识符必须符合以下要求：

  • 在您的目录中，此 ID 应是全局唯一的。
  • 它是静态的。该 ID 必须保持稳定，不应随着时间的推移而发生变化。
  • 其格式为统一资源标识符 (URI)。
  • 其域名必须归贵组织所有。
name 文本

必填 - 提供方的名称。

如果您的品牌有任何特定于语言区域的名称，请在数组中列出这些名称。如需查看示例，请参阅 MediaService 示例。
brandIcon ImageObject

对于所有观看操作和聆听操作，此属性为必需属性：品牌图标的图片文件，每个大小各一份。在“观看/聆听”操作结果中，Google 会将您的内容的深层链接与您的品牌图标相关联。

您的品牌图标图片文件必须符合以下要求：

  • 它是 PNG 文件。
  • 其背景是透明的。
  • 其形状自然是圆形。
  • 确保图片经过抗锯齿处理，没有失真/像素化

此属性必须重复，因为您必须提供五张图片，分别针对以下每个尺寸提供一张：

  • 16 x 16 像素，文件不超过 1 KB
  • 20 x 20 像素，文件不超过 1 KB
  • 40 x 40 像素，文件不超过 1 KB
  • 44 x 44 像素，文件不超过 1 KB
  • 112x112 像素，文件不超过 3 KB

Google TV 集成的额外要求 - 这些品牌图标图片将显示在节目单顶部、观看操作按钮上，以及在 Google TV 设置中。提供三个符合以下要求的图标：

  • 一个采用 PNG 文件格式的方形图标。（分辨率为 512x512 像素，宽高比为 1:1）
  • 一个白色文字商标图标，采用 PNG 文件格式。（最高可用分辨率，无宽高比偏好设置）
  • 一个采用 PNG 文件格式的彩色文字商标图标。（最高可用分辨率，无宽高比偏好设置）

确保图片经过抗锯齿处理，没有失真/像素化。

brandIcon.contentURL 网址

必填 - 图片的网址。
brandIcon.height 编号

必需 - 图片的高度（以像素为单位）。
brandIcon.width 编号

必需 - 图片的宽度（以像素为单位）。
brandIcon.additionalProperty PropertyValue

必需 - 用于描述图片类型并定义其预期用途的额外属性。
brandIcon.additionalProperty.@type 文本

必需 - 设置为 PropertyValue。
brandIcon.additionalProperty.name 文本

必需 - 设置为 contentAttributes。
brandIcon.additionalProperty.value 文本

必需 - 背景是否合适。

必须设置为以下值之一，才能有效：

  • forDarkBackground：适合在深色背景上使用的图片，通常是透明图标。
  • forLightBackground：适合在浅色背景上使用的图片（通常是透明图标）。
application SotfwareApplication

如果提供 iOS、Android、Cast 或 AndroidTV 应用，则必填 - 您在以下平台上提供的品牌应用的列表：

  • iOS
  • Android
  • Cast
  • AndroidTV
application.@type 文本

必需 - 始终设置为 SoftwareApplication。
application.operatingSystem 文本

必需 - 设置为以下各项之一：

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadUrl 网址

如适用，则必填：对于 Android、AndroidTV 和 iOS 平台，您必须将此字段指定为指向 App Store 和 Play 商店中应用的链接。

对于所有其他平台，此属性并非必需属性。
application.installUrl 网址

（如果适用）必填 - 如果提供商通过 AndroidTV 应用提供媒体播放，您必须将此字段指定为指向 AndroidTV APK 文件的链接。

如果提供商不提供 AndroidTV 播放，则此属性不是必需属性。
application.identifier

文本

如适用，则必填 - 对于与以下值之一对应的平台，请相应地进行设置。否则，此属性不是必需的：

  • iOS：App Store 应用标识符。例如 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 文本

必需 - 设置为以下各项之一，这些项对应于 Feed 中包含的商品目录中的内容类型：

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