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

本部分详细介绍了 BroadcastServiceCableOrSatelliteServiceTelevisionChannelOrganization 实体类型的内容标记属性。如需更好地了解这些类型之间的关系,请参阅 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 可抓取的有效规范网址。
。如需了解播放的深层链接,请改为参阅 target 对象的 urlTemplate 属性。
name 文本 必需 - 网络的名称。
  • 可以使用数组列出不同语言的名称。请参阅多区域和多种语言示例。
  • 请注意,每个语言区域(语言-国家/地区对)仅支持一个名称。
broadcastDisplayName 文本 必需属性 - 用户通常在收视指南等内容中看到的广告联盟的显示名称。此值可与 name 值相同。
callSign 文本 政府核发的广播服务官方呼号。
inLanguage 文字语言 强烈推荐为什么?频道的主要播送语言。请使用 IETF BCP 47 标准中的某个语言代码。
category 文本 强烈推荐为什么?商品所属的类别。可以使用更大的符号或斜线来非正式地表示类别层次结构。例如:体育、体育 >足球、新闻、电影、音乐、纪录片。
contentRating 文字评分 仅限成人的电视广播服务所要求的分级 - 针对频道上广播的内容的最严格分级。如果内容分级是以文本字符串的形式指定的,则需要将分级机构附加到分级之前,并在两者之间添加空格;例如“TV-Y”评分机构“TVPG”称为“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 CountryStateCityGeoShape 如果适用,则为必需属性 - 如果频道切换由电视服务提供商提供,则必须提供此属性 - 用户预计会在哪些区域收到广播服务。请使用 ISO 3166-1 国家/地区代码指定国家/地区。
  • 使用数组来表示多个区域。
  • 请勿将 CountryStateCityGeoShape 搭配使用。
  • logo ImageObject 如果与 GoogleTV 集成,则此属性为必需属性其他情况强烈推荐,为什么?表示此广播服务的图片。
    • Google TV 集成需要一个可在深色背景上使用的徽标。应采用透明背景,并带有彩色或白色徽标,在深色背景上清晰可见。
    • 徽标图片的宽高比应为 1:1、4:3 或 16:9(按优先顺序排列),分辨率应为 80x80px 或更高。
    • 将自定义属性名称 contentAttributesforDarkBackground 值用作 additionalProperty 属性的一部分,以指明徽标应使用的背景类型。
    • 如果添加内边距以保持宽高比,可以接受长度或宽度的内边距(但并不能同时采用两者)。
    • 如需了解其他要求和规范,请参阅图片部分。
    请参阅下面的示例
    potentialAction WatchAction 必需(如果适用)- 一个操作标记对象,用于提供操作的详细信息。有关详情,请参阅操作标记属性
    videoFormat 文本 此广播服务支持的最高质量定义;例如,
    • “标清”。
    • “HD”。
    • “2K”。
    • “4K”。
    • “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: 特定于语言区域的受欢迎程度优先于全球 (EARTH) 的热门程度

    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 CountryStateCityGeoShape 必填 - 用户预期可在哪个区域收到广播服务。
    provider 组织 必填 - 服务的父级提供商(如果有)。例如,ExampleTV 是其区域服务 ExampleTV San FranciscoExampleTV 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 属性不同。请只填充谈论单个频道/网络实体的维基百科页面。请注意,维基百科网页可能会使用“channel”术语。
    potentialAction WatchAction 如果适用,则为必填 - 如果您有多个频道 (BroadcastService) 引用该组织,则必须提交此属性。提供操作详情的操作标记对象。有关详情,请参阅操作标记属性
    url 网址 组织的网址。Google 使用此网址来准确匹配该组织与 Google 数据库中的组织。
    identifier PropertyValue 强烈推荐为什么?- 用于标识此实体的外部 ID 或其他 ID,例如此组织的 TMS ID。允许使用多个标识符。如需了解详情,请参阅标识符属性部分。
    popularityScore PopularityScoreSpecification 强烈推荐为什么?Google 会根据此得分以及其他信号来确定要为用户播放哪些媒体。此得分表示该内容相对于目录中其他内容的热门程度;因此,您的 Feed 以及目录中的所有实体中的得分范围需要保持一致。默认情况下,实体的热门程度得分设置为 0。
    popularityScore.@type 文本 始终设置为 PopularityScoreSpecification
    popularityScore.value 编号 表示实体热门程度的非负数值;得分越高,表示热门程度越高。
    popularityScore.eligibleRegion 国家/地区 此热门程度得分适用的地区。如果热门程度得分在全球范围内适用,请设置为 EARTH。默认情况下,此属性会设置为 EARTH
    Note: 特定于语言区域的受欢迎程度优先于全球 (EARTH) 的热门程度

    组织示例

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

    您可以访问以下页面,了解与这些属性相关的主题: