此页面由 Cloud Translation API 翻译。

直播电视频道的内容标记属性

本部分详细介绍了 BroadcastService、CableOrSatelliteService、TelevisionChannel、Organization 实体类型的内容标记属性。如需更好地了解这些类型之间的关系，请查看 LiveTV 频道概念。

BroadcastService 规范表

属性	预期类型	说明
`@context`	文本	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中“xx”代表 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为 BCP 47 格式的适当语言代码。例如，如果语言设置为西班牙语，系统会假定名称也是西班牙语，即使字幕/配音语言是英语也是如此。
`@type`	文本	必需 - 始终设置为 `BroadcastService`。
`@id`	网址	必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在整个目录中全局唯一静态；该 ID 应保持稳定，不应随着时间的推移而发生变化（即使节目的网址属性发生变化也是如此）。它将被视为不透明字符串，且不必是有效链接。采用统一资源标识符 (URI) 格式用于 @id 值的网域必须归贵组织所有。由于实体的 `url` 符合作为标识符的所有要求，因此我们建议您将实体的 `url` 用作 `@id`。如需了解详情，请参阅标识符部分。
`url`	网址	如果适用，则必填 - 如果频道可在互联网上观看，则为该直播服务的规范网址。对于通过有线电视/卫星电视/地面广播提供的服务，此字段为可选字段。Google 会使用此网址将 Feed 中的内容与 Google 数据库中的内容进行匹配。 `url` 必须满足以下要求： `url` 必须是全局唯一的 `url` 必须包含 Google 可以抓取的有效规范网址。如需获取播放的深层链接，请改为查看目标对象的 `urlTemplate` 属性。
`name`	文本	必填 - 影音平台的名称。使用数组列出不同语言的名称。请参阅支持多个区域和语言示例。请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
`broadcastDisplayName`	文本	必填 - 影音平台的显示名称，用户通常可以在节目指南等位置看到此名称。此值可以与名称值相同。
`callSign`	文本	广播服务的官方政府签发呼号。
`inLanguage`	Text 或 Language	强烈建议频道的主要广播语言。请使用 IETF BCP 47 标准中的某种语言代码。
`category`	文本	强烈建议商品所属的类别。可以使用大于号或斜线非正式地表示类别层次结构。例如，体育、体育 > 足球、新闻、电影、音乐、纪录片。`
`contentRating`	Text 或 Rating	仅限成人观看的电视广播服务必须提供 - 频道上播放的内容的限制级别。如果内容分级以文本字符串的形式提供，则需要在分级前面附加分级机构，并在两者之间添加空格；例如，美国分级机构“TVPG”的分级“TV-Y”应描述为“TVPG TV-Y”。请参阅代理机构列表。
`contentRating.author`	组织	如果 `contentRating` 使用 `Rating`，则必填 - 分级机构的名称。
`contentRating.ratingValue`	文本	如果 `contentRating` 使用 `Rating`，则必需 - 分级的值。
`contentRating.advisoryCode`	文本	内容的警示代码。接受的值包括 D、FV、L、S 和 V。D = 对话、FV = 幻想暴力、L = 语言、S = 色情内容、V = 暴力。
`description`	文本	广播服务的说明。字符数限制为 300 个。使用数组以多种语言和/或不同长度提供说明。
`slogan`	文本	广播服务的宣传口号。
`areaServed`	国家/地区、州/省/直辖市/自治区、城市或 GeoShape	如果适用，则必填 - 如果频道切换由电视服务提供商执行，则必须填写此字段 - 用户预计可接收广播服务的区域。使用 ISO 3166-1 国家/地区代码指定国家/地区。使用数组表示多个区域。请勿将国家/地区、州/省/直辖市/自治区、城市与 GeoShape 混用。
`logo`	ImageObject	如果与 GoogleTV 集成，则必须提供此字段。强烈建议原因代表此广播服务的图片。 GoogleTV 集成需要一个可在深色背景上使用的徽标。徽标应采用透明背景，并使用彩色或白色徽标，且在深色背景上清晰可见。徽标图片的宽高比应为 1:1、4:3 或 16:9（优先顺序），分辨率应不低于 80x80 像素。将自定义属性名称 `contentAttributes` 的 `forDarkBackground` 值用作 `additionalProperty` 属性的一部分，以指明应在哪种背景上使用徽标。如果是为了保持宽高比而添加内边距，则可以添加长度或宽度（但不能同时添加）内边距。如需了解其他要求和规范，请参阅图片部分。请参阅下面的示例
`potentialAction`	WatchAction	如果适用，则必须提供 - 一个操作标记对象，用于提供操作的详细信息。如需了解详情，请参阅Action 标记属性。使用数组指定多个区域中的不同深层链接。请参阅支持多个区域和语言示例。如果频道切换由电视服务提供商执行，则可以选择提供深层链接。
`videoFormat`	文本	此广播服务支持的最高画质定义；例如， “SD”表示标清。 “HD”表示高清。 “2K”表示 2K 分辨率。 “4K”表示 4K 分辨率。 “8K”表示 8K 分辨率。
`broadcastTimezone`	文本	此广播服务的时区（采用 IANA 格式）；例如，America/Los_Angeles。使用数组处理多个时区。
`broadcastAffiliateOf`	组织	必填 - 为此广播服务提供节目的电视网络，或此广播服务所属的组织。
`broadcastAffiliateOf.@id`	文本	必需 - 设置为电视网络的 `@id`。
`broadcastAffiliateOf.@type`	文本	必需 - 始终设置为 `Organization`。
`identifier`	PropertyValue	强烈建议- 用于标识此实体的外部 ID 或其他 ID，例如 _PARTNER_ID_。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。
`popularityScore`	PopularityScoreSpecification	强烈建议一种得分，Google 会根据该得分以及其他信号来确定向用户播放哪种媒体。此评分表示相应内容相对于目录中其他内容的热门程度；因此，您 Feed 中所有实体以及目录中所有实体的评分比例需要保持一致。默认情况下，实体的热门程度得分设为 0。
`popularityScore.@type`	文本	始终设置为 `PopularityScoreSpecification`。
`popularityScore.value`	编号	一个非负数值，表示实体的受欢迎程度；得分越高，受欢迎程度越高。
`popularityScore.eligibleRegion`	国家/地区	此人气指数适用的地区。如果热门程度得分适用于全球，请设为 `EARTH`。默认情况下，此属性设置为 `EARTH`。 `Note:` 特定语言区域的热门程度优先于全球（地球）热门程度

BroadcastService 示例

{
    "@context": [
        "http://schema.org",
        {
            "@language": "en"
        }
    ],
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example-tv",
    "name": "EXAMPLE-TV",
    "broadcastDisplayName": "ABCD",
    "url": "http://example.com/stations/example-tv",
    "callSign": "EXA-TV",
    "videoFormat": "SD",
    "inLanguage": "en",
    "broadcastTimezone": "America/Los_Angeles",
    "broadcastAffiliateOf": {
        "@type": "Organization",
        "@id": "http://example.com/networks/abcd-network"
    },
    "identifier": [
        {
            "@type": "PropertyValue",
            "propertyID": "TMS_ID",
            "value": "12258"
        },
        {
            "@type": "PropertyValue",
            "propertyID": "_PARTNER_ID_",
            "value": "exampletv-123456"
        }
    ],
    "popularityScore": {
        "@type": "PopularityScoreSpecification",
        "value": 178,
        "eligibleRegion": [
            {
                "@type": "Country",
                "name": "US"
            }
        ]
    },
    "potentialAction": {
        "@type": "WatchAction",
        "target": {
            "@type": "EntryPoint",
            "urlTemplate": "http://example.com/livestream",
            "actionPlatform": [
                "http://schema.org/DesktopWebPlatform",
                "http://schema.org/MobileWebPlatform",
                "http://schema.org/AndroidPlatform",
                "http://schema.org/IOSPlatform",
                "http://schema.googleapis.com/GoogleVideoCast",
                "http://schema.org/AndroidTVPlatform"
            ]
        },
        "actionAccessibilityRequirement": {
            "@type": "ActionAccessSpecification",
            "category": "externalsubscription",
            "availabilityStarts": "2018-07-21T10:35:29Z",
            "availabilityEnds": "2019-10-21T10:35:29Z",
            "requiresSubscription": {
                "@type": "MediaSubscription",
                "@id": "http://example.com/subscription",
                "name": "ABCD",
                "sameAs": "http://example.com/subscription",
                "authenticator": {
                    "@type": "Organization",
                    "name": "TVE"
                }
            },
            "eligibleRegion": [
                {
                    "@type": "Country",
                    "name": "US"
                }
            ]
        }
    },
    "logo": [
        {
            "@context": "http://schema.org",
            "@type": "ImageObject",
            "name": "Example Logo Light",
            "contentUrl": "http://example.com/images/example-logo-light.jpg",
            "additionalProperty": [
                {
                    "@type": "PropertyValue",
                    "name": "contentAttributes",
                    "value": [
                        "forLightBackground"
                    ]
                }
            ]
        },
        {
            "@context": "http://schema.org",
            "@type": "ImageObject",
            "name": "Example Logo Dark",
            "contentUrl": "http://example.com/images/example-logo-dark.jpg",
            "additionalProperty": [
                {
                    "@type": "PropertyValue",
                    "name": "contentAttributes",
                    "value": [
                        "forDarkBackground"
                    ]
                }
            ]
        }
    ]
}

CableOrSatelliteService 规范表

属性	预期类型	说明
`@context`	文本	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中“xx”代表 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为 BCP 47 格式的适当语言代码。例如，如果语言设置为西班牙语，系统会假定名称也是西班牙语，即使字幕/配音语言是英语也是如此。
`@type`	文本	必需 - 始终设置为 `CableOrSatelliteService`。
`@id`	网址	必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在整个目录中全局唯一静态采用统一资源标识符 (URI) 格式由于实体的 `url` 符合作为标识符的所有要求，因此我们建议您将实体的 `url` 用作 `@id`。如需了解详情，请参阅标识符部分。
`name`	文本	必需 - 电视服务的名称。使用数组列出不同语言的名称。请参阅支持多个区域和语言示例。请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
`areaServed`	国家/地区、州/省/直辖市/自治区、城市或 GeoShape	必填 - 用户预计可在哪个区域接收广播服务。使用 ISO 3166-1 国家/地区代码指定国家/地区。使用数组表示多个区域。请勿将国家/地区、州/省/直辖市/自治区、城市与 GeoShape 混用。如需了解详细要求，请参阅 GeoShape 属性部分。
`provider`	组织	必填 - 服务的父级提供商（如果适用）。例如，ExampleTV 是其区域性服务 ExampleTV San Francisco 和 ExampleTV San Diego 的提供商。
`provider.@id`	文本	必填 - 电视运营商的 ID。
`provider.@type`	文本	必需 - 始终设置为 `Organization`。
`identifier`	PropertyValue	强烈建议- 用于标识此实体的外部 ID 或其他 ID，例如此广播服务的 Gracenote TMS ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。

CableOrSatelliteService 示例

有线电视或卫星电视服务示例：

{
  "@context":["http://schema.org", {"@language": "en"}],
  "@type":"CableOrSatelliteService",
  "@id":"http://example.com/provider-lineups/exampletv-san-francisco",
  "name":"ExampleTV San Francisco",
  "provider": {
    "@type": "Organization",
    "@id": "http://example.com/providers/exampletv"
  },
  "areaServed":[
    {
      "@type":"GeoShape",
      "@id": "http://example.com/area1"
    }
  ],
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "TMS_ID",
    "value": "12345"
  }
}

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

虚拟多频道视频节目分发商 (vMVPD) 示例：

{
  "@context":["http://schema.org", {"@language": "en"}],
  "@type":"CableOrSatelliteService",
  "@id":"http://example.com/providers/my-online-example-tv",
  "name":"My Online Example TV",
  "provider": {
    "@type": "Organization",
    "@id": "http://my-online-tv.com"
  },
  "areaServed":[
    {
      "@type":"Country",
      "name": "US",
    },
    {
      "@type":"Country",
      "name": "CA",
    }
  ]
}

TelevisionChannel 规范表

属性	预期类型	说明
`@context`	文本	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中“xx”代表 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为 BCP 47 格式的适当语言代码。例如，如果语言设置为西班牙语，系统会假定名称也是西班牙语，即使字幕/配音语言是英语也是如此。
`@type`	文本	必需 - 始终设置为 `TelevisionChannel`。
`@id`	网址	必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在整个目录中全局唯一静态采用统一资源标识符 (URI) 格式由于实体的 `url` 符合作为标识符的所有要求，因此我们建议您将实体的 `url` 用作 `@id`。如需了解详情，请参阅标识符部分。
`broadcastChannelId`	文本	必需 - 一个唯一标识符，可用于将此 `BroadcastService` 标识为有线电视、卫星电视或互联网电视服务。在美国，此编号通常是指有线电视或卫星电视的编号。对于互联网电视服务（例如 vMVPD），请提供频道名称。
`channelOrder`	编号	对于 GoogleTV 为必需属性，否则为可选属性 - 使用此属性可指明频道应在 Google TV 集成的电子节目单中显示的顺序。 `channelOrder` 在 Feed 中的各个渠道中应是唯一的，最好从 1 开始。`channelOrder` 的值不能为负数或 0。
`broadcastServiceTier`	文本	请使用以下值： `Free`（适用于无需订阅的频道）。 `Standard`（适用于基本订阅中包含的频道）。 `Premium`（适用于需要在基本订阅之外支付费用的频道）。使用数组提供多个值。
`inBroadcastLineup`	CableOrSatelliteService	必需 - 向观看者提供此频道的 `CableOrSatelliteService` 的 `@id`。
`providesBroadcastService`	BroadcastService	必需 - 此频道提供节目的 `BroadcastService` 的 `@id`。

TelevisionChannel 示例

有线电视或卫星电视频道示例：

{
  "@context":["http://schema.org", {"@language": "en"}],
  "@type":"TelevisionChannel",
  "@id":"http://example.com/channels/exampleTV/example-tv-7",
  "broadcastChannelId":"7",
  "channelOrder": 1,
  "broadcastServiceTier":["Premium", "Standard"],
  "inBroadcastLineup":{
    "@type":"CableOrSatelliteService",
    "@id":"http://example.com/providers/exampleTV-san-francisco"
  },
  "providesBroadcastService":{
    "@type":"BroadcastService",
    "@id":"http://example.com/stations/example-tv"
  }
}

在线电视频道示例：

{
  "@context":["http://schema.org", {"@language": "en"}],
  "@type":"TelevisionChannel",
  "@id":"http://example.com/channels/my-online-example-tv/sport-channel",
  "broadcastChannelId":"sport-channel",
  "channelOrder": 3,
  "broadcastServiceTier":"Premium",
  "inBroadcastLineup":{
    "@type":"CableOrSatelliteService",
    "@id":"http://example.com/providers/my-online-example-tv"
  },
  "providesBroadcastService":{
    "@type":"BroadcastService",
    "@id":"http://example.com/stations/sport-channel"
  }
}

组织规范表

属性	预期类型	说明
`@context`	文本	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中“xx”代表 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为 BCP 47 格式的适当语言代码。例如，如果语言设置为西班牙语，系统会假定名称也是西班牙语，即使字幕/配音语言是英语也是如此。
`@type`	文本	必需 - 始终设置为 `Organization`。
`@id`	网址	必填 - 内容的标识符（采用 URI 格式）；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在整个目录中全局唯一静态采用统一资源标识符 (URI) 格式由于实体的 `url` 符合作为标识符的所有要求，因此我们建议您将实体的 `url` 用作 `@id`。如需了解详情，请参阅标识符部分。
`name`	文本	必填 - 电视网络、电视内容提供商或电视运营商的名称。使用数组列出不同语言的名称。请参阅支持多个区域和语言示例。请注意，每个语言区域（语言-国家/地区对）仅支持一个名称。
`description`	文本	组织的说明。字符数限制为 300 个。使用数组以多种语言和/或不同长度提供说明。
`sameAs`	网址	强烈建议可标识电视网络的维基百科页面的网址。此属性必须不同于“url”属性。仅填充介绍单个频道/影音平台实体的维基百科页面。请注意，维基百科页面可能会使用术语“渠道”。
`potentialAction`	WatchAction	如适用，则必填 - 如果您有多个频道 (BroadcastService) 引用组织，则必须填写此字段。一个操作标记对象，用于提供操作的详细信息。如需了解详情，请参阅Action 标记属性。使用数组指定多个区域中的不同深层链接。请参阅支持多个区域和语言示例。如果频道切换由电视服务提供商执行，则可以选择提供深层链接。
`url`	网址	组织的网址。Google 会使用此网址将此组织与 Google 数据库中的组织进行准确匹配。
`identifier`	PropertyValue	强烈建议- 用于标识此实体的外部 ID 或其他 ID，例如此组织的 TMS ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。
`popularityScore`	PopularityScoreSpecification	强烈建议一种得分，Google 会根据该得分以及其他信号来确定向用户播放哪种媒体。此评分表示相应内容相对于目录中其他内容的热门程度；因此，您 Feed 中所有实体以及目录中所有实体的评分比例需要保持一致。默认情况下，实体的热门程度得分设为 0。
`popularityScore.@type`	文本	始终设置为 `PopularityScoreSpecification`。
`popularityScore.value`	编号	一个非负数值，表示实体的受欢迎程度；得分越高，受欢迎程度越高。
`popularityScore.eligibleRegion`	国家/地区	此人气指数适用的地区。如果热门程度得分适用于全球，请设为 `EARTH`。默认情况下，此属性设置为 `EARTH`。 `Note:` 特定语言区域的热门程度优先于全球（地球）热门程度

组织示例

{
  "@context":["http://schema.org", {"@language": "en"}],
  "@type":"Organization",
  "@id":"http://example.com/networks/abcd-network",
  "name":"ABCD",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value": "12345"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "_PARTNER_ID_",
      "value": "exampletv-12345"
    }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/networkstream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2050-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 178,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      }
    ]
  }
}