此页面由 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 可抓取的有效规范网址。。如需了解播放的深层链接，请改为参阅 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`	Country、State、City 或 GeoShape	如果适用，则为必需属性 - 如果频道切换由电视服务提供商提供，则必须提供此属性 - 用户预计会在哪些区域收到广播服务。请使用 ISO 3166-1 国家/地区代码指定国家/地区。使用数组来表示多个区域。请勿将 Country、State、City 与 GeoShape 搭配使用。
`logo`	ImageObject	如果与 GoogleTV 集成，则此属性为必需属性。其他情况强烈推荐，为什么？表示此广播服务的图片。 Google TV 集成需要一个可在深色背景上使用的徽标。应采用透明背景，并带有彩色或白色徽标，在深色背景上清晰可见。徽标图片的宽高比应为 1:1、4:3 或 16:9（按优先顺序排列），分辨率应为 80x80px 或更高。将自定义属性名称 `contentAttributes` 的 `forDarkBackground` 值用作 `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`	Country、State、City 或 GeoShape	必填 - 用户预期可在哪个区域收到广播服务。请使用 ISO 3166-1 国家/地区代码指定国家/地区。使用数组来表示多个区域。请勿将 Country、State、City 与 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 属性不同。请只填充谈论单个频道/网络实体的维基百科页面。请注意，维基百科网页可能会使用“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"
      }
    ]
  }
}