Content markup properties of Live TV

This section provides the details of the content markup properties for the BroadcastService entity type.

Specification table

Property Expected Type Description
@context Text Required - Always set to ["http://schema.org", {"@language": "xx"}]
  • Replace xx with the entity's language code in BCP 47 format format, for example, "en".
@type Text Required - Always set to BroadcastService for Live TV.
@id URL Required - The content's identifier in URI format; for example, https://example.com/1234abc.
@id must meet the following requirements:
  • Globally unique across your catalog
  • Static
  • In the form of Unified Resource Identifier (URI)
Because an entity's url meets all the requirements as an identifier, we recommend you use an entity's url as @id. See the Identifier for more details.
url URL Required - The content's canonical URL, which Google uses to match the content in your feed to the content in Google's databases.
url must meet the following requirements:
  • url must be globally unique
  • url must contain a working canonical URL that Google can crawl.
For playback's deep link, see the target object's urlTemplate property instead.
name Text Required - The name of the network.
broadcastDisplayName Text Required - The display name for the network that users may typically see in program guides etc. The value may be the same as the name value.
potentialAction WatchAction Required - An Action markup object that provides the details of the action. See the Action markup properties for details.
sameAs URL A URL to a reference web page that can identify the network; for example, the Wikipedia page of the network. This must be distinct from the url property.
image ImageObject Images related to the Live TV service. Must be a minimum of 140px wide by 210px tall, with a 2:3 aspect ratio. Provide highest-resolution available, PNG or JPG.
identifier PropertyValue External or other ID that unambiguously identifies this entity. Multiple identifiers are allowed. See Identifier Properties section for details.

Example

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastService",
  "@id": "http://www.example.com/livestream",
  "url": "http://www.example.com/livestream",
  "sameAs": "https://en.wikipedia.org/wiki/example_tv_station_(TV_channel)",
  "name": "Example TV Station",
  "broadcastDisplayName": "ABC-D",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.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"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2017-07-21T10:35:29Z",
      "availabilityEnds": "2018-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://www.example.com/subscription",
        "name": "AMC",
        "sameAs": "http://www.example.com/subscription",
        "authenticator": {
          "@type": "Organization",
          "name": "TVE"
        }
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "co0019701"
    }
  ]
}

Check out the following pages for the topics related to these properties: