MediaService 的内容标记属性(必需)

本部分详细介绍了 MediaService 实体类型,用于捕获媒体操作的配置 集成

规格表

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

必需 - 始终设置为 MediaService

@context 文字

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

@id 网址

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

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

  • 在您的整个目录中,该 ID 是全局唯一的。
  • 是静态的。该 ID 必须保持稳定,不得随时间变化。
  • 它采用统一资源标识符 (URI) 格式。
  • 其网域必须归贵组织所有。
name 文字

必需 - 提供商的名称。

如果您的品牌有任何特定于语言区域的名称,请以数组的形式列出它们。举个例子 请参阅 MediaService 示例

brandIcon ImageObject

所有观看操作和收听操作都必须提供 - 您的品牌的图片文件 图标,并重复使用。在观看/收听操作结果中,Google 会将您的 指向您的品牌图标的内容深层链接。

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

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

此属性必须重复,因为您必须提供五张图片, 以下维度:

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

Google TV 集成的其他要求 - 这些品牌图片 图标会显示在收视指南顶部的“观看操作”按钮和 。提供符合以下要求的三个图标:

  • 1 个 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 应用,则必须将其指定为 Android TV APK 文件的链接。

如果提供商不提供 Android TV 播放服务,则此属性不是必需属性。

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 处理。从本质上讲, 返回所请求内容的深层链接。
  • Provider:所有请求都由 content provider(即 云服务提供商。从本质上讲,提供程序会返回所请求内容的深层链接 或直接在用户设备上开始播放内容

默认情况下,此属性设置为 Google

mediaOffered 文字

必需 - 设置为以下其中一项,与 Feed 中包含的目录:

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