此页面由 Cloud Translation API 翻译。

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

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

BroadcastService 规范表

属性	预期类型	说明
`@context`	Text	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为相应的语言代码（采用 BCP 47 格式格式）。例如，如果语言设置为西班牙语，即使字幕/配音语言为英语，系统也会假定名称为西班牙语。
`@type`	Text	必需 - 始终设置为 `BroadcastService`。
`@id`	网址	必需 - 内容的标识符，采用 URI 格式；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在您的整个目录中具有全局唯一性静态；ID 应保持稳定，不应随着时间改变（即使节目的网址属性发生变化）。系统会将此字符串视为不透明字符串，且不一定是有效链接。采用统一资源标识符 (URI) 的形式使用 @id 值的域名必须归贵组织所有。由于实体的 `url` 满足标识符的所有要求，因此我们建议您将实体的 `url` 用作 `@id`。如需了解详情，请参阅标识符部分。
`url`	网址	必需（如果适用） - 广播服务的规范网址，前提是频道可在互联网上观看。对于通过有线/卫星/无线下载方式提供的服务，此字段是可选的。Google 使用此网址将您的 Feed 中的内容与 Google 数据库中的内容进行匹配。 `url`必须满足以下要求： “`url`”必须是全局唯一的 `url` 必须包含可供 Google 抓取的有效规范网址。：如需了解播放的深层链接，请参阅目标对象的 `urlTemplate` 属性。
`name`	Text	必需 - 广告联盟的名称。使用数组列出不同语言的名称。请参阅多个区域和语言示例。请注意，每个语言区域仅支持一个名称（语言-国家/地区对）。
`broadcastDisplayName`	Text	必需 - 用户在节目指南中通常看到的网络的显示名称。此值可能与名称值相同。
`callSign`	Text	政府签发的广播服务呼号。
`inLanguage`	Text 或 Language	强烈建议原因频道的主要广播语言。请使用 IETF BCP 47 标准中的一种语言代码。
`category`	Text	强烈建议原因商品所属类别。大符号或斜杠可用于以非正式的方式指明某个类别的层次结构。例如，体育、体育 > 足球、新闻、电影、音乐、纪实。
`contentRating`	文字或评分	仅限成人使用的电视广播服务 - 对频道内容广播的限制最为严格。如果内容分级是以文本字符串的形式提供的，则分级机构需要在其前面加上空白，二者之间应留有空白；例如，在美国，来自代理机构“TVPG”的分级为“TV-Y”，该分级称为“TVPG TV-Y”。请参阅代理机构列表。
`contentRating.author`	文字或组织	如果 `contentRating` 使用 `Rating`，则为必需项 - 分级机构的名称。
`contentRating.ratingValue`	Text	如果 `contentRating` 使用 `Rating`，则为必需值 - 评分的值。
`contentRating.advisoryCode`	Text	内容的建议代码。接受的值包括 D、FV、L、S 和 V；D = 对话、FV = 幻想暴力内容、L = 语言、S = 色情内容、V = 暴力内容。
`description`	Text	广播服务的说明。字符数限制为 300 个。使用数组以多种语言和/或以不同长度提供说明。
`slogan`	Text	广播服务的口号。
`areaServed`	Country、State、City 或 GeoShape	如果适用（必填） - 如果频道开关由电视服务提供商执行，则必须提供。用户预计会在其中接收广播服务的区域。可以使用 ISO 3166-1 国家/地区代码指定国家/地区。使用数组来表示多个区域。请勿将国家/地区、州/省/自治区/直辖市、城市与 GeoShape 混合使用。
`logo`	ImageObject	必须与 Google TV 集成时才需要。强烈建议（否则）为什么？代表此广播服务的图片。与 Google TV 集成需要一个可在深色背景中使用的徽标。透明背景应该包含彩色或白色徽标，在深色背景上清晰可见。徽标图片应采用 1:1、4:3 或 16:9 的宽高比（按偏好顺序排列），分辨率应为 80x80 像素或以上。使用自定义属性名称 `contentAttributes` 的 `forDarkBackground` 值作为 `additionalProperty` 属性的一部分，以指明应使用该徽标的背景类型。如果为增加宽高比而保留长度或宽度（但不是两者皆可）填充，可接受。如需了解其他要求和规范，请参阅映像部分。请参见下面的示例
`potentialAction`	WatchAction	如果适用（必需）- 一个操作标记对象，用于提供操作的详细信息。如需了解详情，请参阅操作标记属性。使用数组在多个区域中指定不同的深层链接。请参阅多个区域和语言示例。如果频道开关由电视服务提供商执行，可以选择提供深层链接。
`videoFormat`	Text	此广播服务支持的最高质量定义；例如，标清则为“标清”。 “HD”代表高清。 2K 分辨率显示“2K”。 4K 分辨率为“4K”。 “8K”表示分辨率为 8K。
`broadcastTimezone`	Text	此广播服务的时区，采用 IANA 格式，例如 America/Los_Angeles。一个数组用于多个时区。
`broadcastAffiliateOf`	组织	必需 - 提供此广播服务或此广播服务所属组织的节目的电视网络。
`broadcastAffiliateOf.@id`	Text	必需 - 设为电视网络的 `@id`。
`broadcastAffiliateOf.@type`	Text	必需 - 始终设置为 `Organization`。
`identifier`	PropertyValue	强烈建议原因- 用于标识此实体的外部 ID 或其他 ID，例如 _PARTNER_ID_。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。
`popularityScore`	热门程度得分规范	强烈建议原因Google 根据这一得分及其他一些信号来确定为用户播放哪种媒体内容。此得分表示内容相对于您目录中其他内容的受欢迎程度；因此，该得分在各 Feed 之间在目录中的所有实体中必须保持一致。默认情况下，实体的热门程度分数设为 0。
`popularityScore.@type`	Text	始终设置为 `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`	Text	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为相应的语言代码（采用 BCP 47 格式格式）。例如，如果语言设置为西班牙语，即使字幕/配音语言为英语，系统也会假定名称为西班牙语。
`@type`	Text	必需 - 始终设置为 `CableOrSatelliteService`。
`@id`	网址	必需 - 内容的标识符，采用 URI 格式；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在您的整个目录中具有全局唯一性静态采用统一资源标识符 (URI) 的形式由于实体的 `url` 满足标识符的所有要求，因此我们建议您将实体的 `url` 用作 `@id`。如需了解详情，请参阅标识符部分。
`name`	Text	必需 - 电视服务的名称。使用数组列出不同语言的名称。请参阅多个区域和语言示例。请注意，每个语言区域仅支持一个名称（语言-国家/地区对）。
`areaServed`	Country、State、City 或 GeoShape	必需 - 用户预计会接收广播服务的领域。可以使用 ISO 3166-1 国家/地区代码指定国家/地区。使用数组来表示多个区域。请勿将国家/地区、州/省/自治区/直辖市、城市与 GeoShape 混合使用。如需了解详细要求，请参阅 GeoShape 属性部分。
`provider`	组织	必需 - 服务的父级提供商（如果适用）。例如，ExampleTV 是其区域服务 ExampleTV San Francisco 和 ExampleTV San Diego 的提供商。
`provider.@id`	Text	必需 - 电视运营商的 ID。
`provider.@type`	Text	必需 - 始终设置为 `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`	Text	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为相应的语言代码（采用 BCP 47 格式格式）。例如，如果语言设置为西班牙语，即使字幕/配音语言为英语，系统也会假定名称为西班牙语。
`@type`	Text	必需 - 始终设置为 `TelevisionChannel`。
`@id`	网址	必需 - 内容的标识符，采用 URI 格式；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在您的整个目录中具有全局唯一性静态采用统一资源标识符 (URI) 的形式由于实体的 `url` 满足标识符的所有要求，因此我们建议您将实体的 `url` 用作 `@id`。如需了解详情，请参阅标识符部分。
`broadcastChannelId`	Text	必需 - 此 `BroadcastService` 可标识为有线、卫星或互联网电视服务的唯一标识符。在美国，通常为有线电视或卫星电视的数字。对于互联网电视服务（例如 vMVPD），请提供频道名称。
`channelOrder`	编号	对于 GoogleTV 是必需的，否则为可选 - 使用此属性可指定频道在 Google TV 集成方案的电子收视指南中的显示顺序。 `channelOrder`在 Feed 中的各个渠道中应是独一无二的，理想情况下应从 1 开始。“`channelOrder`”的值不能为负或 0。
`broadcastServiceTier`	Text	请使用以下值：为不要求订阅的频道设置 `Free`。 `Standard`：适用于基本订阅中包含的频道。对于需要基本订阅模式的频道，才需支付 `Premium` 费用。使用数组提供多个值。
`inBroadcastLineup`	有线电视卫星服务	必需 - 向观看者提供此频道的 `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`	Text	必需 - 始终设置为 `["http://schema.org", {"@language": "xx"}]` 其中，“xx”表示 Feed 中字符串的语言。每个根实体上下文都应将其 @language 设置为相应的语言代码（采用 BCP 47 格式格式）。例如，如果语言设置为西班牙语，即使字幕/配音语言为英语，系统也会假定名称为西班牙语。
`@type`	Text	必需 - 始终设置为 `Organization`。
`@id`	网址	必需 - 内容的标识符，采用 URI 格式；例如 https://example.com/1234abc。 `@id` 必须满足以下要求：在您的整个目录中具有全局唯一性静态采用统一资源标识符 (URI) 的形式由于实体的 `url` 满足标识符的所有要求，因此我们建议您将实体的 `url` 用作 `@id`。如需了解详情，请参阅标识符部分。
`name`	Text	必需 - 电视网络、电视内容提供方或电视运营商的名称。使用数组列出不同语言的名称。请参阅多个区域和语言示例。请注意，每个语言区域仅支持一个名称（语言-国家/地区对）。
`description`	Text	对组织的说明。字符数限制为 300 个。使用数组以多种语言和/或以不同长度提供说明。
`sameAs`	网址	强烈建议原因指向维基百科页面（可识别电视网络）的网址。此网址必须与网址属性不同。仅使用介绍单个频道/网络实体的维基百科页面。请注意，维基百科页面可以使用术语“频道”。
`potentialAction`	WatchAction	如果适用（必须提供） - 如果您有多个频道 (BroadcastService) 引用该组织，则必须提供。一个操作标记对象，用于提供操作的详细信息。如需了解详情，请参阅操作标记属性。使用数组在多个区域中指定不同的深层链接。请参阅多个区域和语言示例。如果频道开关由电视服务提供商执行，可以选择提供深层链接。
`url`	网址	组织的网址。Google 使用此网址与 Google 数据库中的组织准确核对。
`identifier`	PropertyValue	强烈建议原因- 用于标识此实体的外部 ID 或其他 ID，例如此组织的 TMS ID。允许使用多个标识符。如需了解详情，请参阅标识符属性部分。
`popularityScore`	热门程度得分规范	强烈建议原因Google 根据这一得分及其他一些信号来确定为用户播放哪种媒体内容。此得分表示内容相对于您目录中其他内容的受欢迎程度；因此，该得分在各 Feed 之间在目录中的所有实体中必须保持一致。默认情况下，实体的热门程度分数设为 0。
`popularityScore.@type`	Text	始终设置为 `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"
      }
    ]
  }
}