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

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

规范表

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

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

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

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

该标识符必须遵循以下要求：

  • 在您的目录中具有全局唯一性。
  • 而是静态的。ID 必须保持稳定，并且不会随时间发生变化。
  • 它采用统一资源标识符 (URI) 格式。
  • 域名必须归贵组织所有。
name 文字

必需 - 提供商的名称。

如果您的品牌有任何特定于语言区域的名称，请以数组的形式列出。有关示例，请参阅 MediaService 示例。
brandIcon ImageObject

对于所有观看操作和聆听操作是必需的 - 您的品牌图标的图片文件，对每个尺寸重复。在“观看/收听操作”结果中，Google 会将内容的深层链接与您的品牌图标相关联。

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

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

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

  • 16x16 像素，文件大小不超过 1 KB
  • 20x20 像素，文件大小不超过 1 KB
  • 40x40 像素，文件大小不超过 1 KB
  • 44x44 像素，文件大小不超过 1 KB
  • 112x112 像素，文件大小不超过 3 KB

Google TV 集成的其他要求 - 您的品牌图标的这些图片将显示在“编程指南”的顶部、“观看操作”按钮和 Google TV 设置中。提供三个符合以下要求的图标：

  • PNG 格式的一个方形图标。（分辨率为 512x512 像素，宽高比为 1:1）
  • PNG 文件格式的一个白色文字图标。（支持最高分辨率，宽高比不受支持）
  • 一个彩色 PNG 格式的文字图标图标。（支持最高分辨率，宽高比不受支持）

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

brandIcon.contentURL 网址

必需 - 图片的网址。
brandIcon.height 数字

必需 - 图片的高度，以像素为单位。
brandIcon.width 数字

必需 - 图片的宽度，以像素为单位。
brandIcon.additionalProperty 属性值

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

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

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

必需 - 对背景的适宜性。

为有效，请至少设置以下值之一：

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

如果提供 iOS、Android、Cast 或 AndroidTV 应用，则为必需项 - 您的品牌应用列表涵盖以下方面：

  • iOS
  • Android
  • Cast
  • Android 电视
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。
  • 投放：投放应用 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：所有请求均由 Content Provider（即 Cloud 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"
      }
    }
  ]
}