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; The ID should be stable and not change over time (even if the url property of the show changes). It will be treated as an opaque string and does not have to be a working link.
  • In the form of Unified Resource Identifier (URI)
  • The domain used for the @id value must be owned by your organization.
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 section 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 Highly Recommended Why? - 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/AndroidTVPlatform",
        "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: