Propriétés de balisage du contenu des événements télévisés en direct

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette section détaille les propriétés de balisage de contenu pour le type d'entité BroadcastEvent.

Table des spécifications BroadcastEvent

Propriété Type attendu Description
@context Texte Obligatoire - Toujours défini sur ["http://schema.org", {"@language": "xx"}]
  • Remplacez xx par le code de langue de l'entité au format BCP 47, par exemple "en".
@type Texte Obligatoire : toujours défini sur BroadcastEvent.
@id URL Obligatoire : identifiant du contenu au format URI. Par exemple, https://example.com/1234abc.
@id doit répondre aux exigences suivantes :
  • Unique dans votre catalogue
  • Statique ; l'identifiant doit être stable et immuable dans le temps (même si la propriété url de l'émission change). Il sera traité comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel.
  • Sous la forme d'un identifiant de ressource unifié (URI)
  • Le domaine utilisé pour la valeur @id doit appartenir à votre organisation.
Étant donné que le url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser le url d'une entité comme @id. Consultez la section Identifiant pour en savoir plus.
name Texte Obligatoire : titre de l'émission ou de l'événement.
description Texte Description de l'émission ou de l'événement. Limiste de 300 caractères. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et longueurs.
startDate Date Obligatoire : heure de début de l'événement au format ISO 8601 avec fuseau horaire.
endDate Date Heure de fin de l'événement au format ISO 8601, avec fuseau horaire.
publishedOn BroadcastService Obligatoire, le cas échéant : spécifiez l'entité BroadcastService qui diffuse l'émission ou l'événement.

Si le contenu est diffusé sur une chaîne de télévision, cette propriété est obligatoire. Si le contenu n'est associé à aucune chaîne de télévision, ne fournissez pas cette propriété.
publishedOn.@type Texte Définissez cet élément sur BroadcastService.
publishedOn.@id URL @id de l'entité BroadcastService qui diffuse cette émission ou cet événement.
workPerformed CreativeWork Obligatoire si applicable : utilisez cette propriété lorsque le contenu correspond à l'un des types d'entités suivants : Movie, TVSeries, TVSeason et TVEpisode.

Une entité BroadcastEvent doit inclure exactement l'un des éléments suivants :
  • travaileffectué
  • événement de diffusion
  • contentToBeAnnounced défini sur true
  • Fonction offAir sur true
workPerformed.@type Texte Définissez ce paramètre sur Movie, TVSeries, TVSeason ou TVEpisode.
workPerformed.@id URL @id de l'entité de contenu.
broadcastOfEvent Event, MusicEvent ou SportsEvent Obligatoire si applicable : utilisez cette propriété si le contenu est un événement en direct :
  • Pour un événement sportif, cette propriété doit faire référence à une entité SportsEvent.
  • Pour un événement musical, cette propriété doit faire référence à une entité MusicEvent.
  • Pour les autres types d'événements, cette propriété doit faire référence à une entité Event générique.


Une entité BroadcastEvent doit inclure exactement l'un des éléments suivants:
  • travaileffectué
  • événement de diffusion
  • contentToBeAnnounced défini sur true
  • Fonction offAir sur true
broadcastOfEvent.@type Texte Définissez ce paramètre sur SportsEvent, MusicEvent ou Event.
broadcastOfEvent.@id URL @id de l'entité d'événement. L'entité d'événement doit exister dans le flux et présenter un @id différent de celui de BroadcastEvent.
videoFormat Texte La meilleure définition possible pour ce service de diffusion. Par exemple :
  • "SD" pour une définition standard.
  • "HD" pour la haute définition.
  • "2K" pour une résolution 2K.
  • "4K" pour une résolution 4K
  • "8K" pour une résolution 8K.
contentToBeAnnounced Booléen Obligatoire
  • travaileffectué
  • événement de diffusion
  • contentToBeAnnounced défini sur true
  • Fonction offAir sur true
  • offAir Booléen Obligatoire
  • travaileffectué
  • événement de diffusion
  • contentToBeAnnounced défini sur true
  • Fonction offAir sur true
  • isLiveBroadcast Booléen Définissez la valeur sur true s'il s'agit d'un événement en direct, par exemple un événement sportif ou un concert.
    potentialAction WatchAction Obligatoire, le cas échéant - Si le contenu n'est pas marqué contentToBeAnnounced true ni hors diffusion true, mais qu'il est diffusé en direct, utilisez cette propriété pour fournir le lien profond de l'événement.

    Exemples BroadcastEvent

    Un épisode de série télévisée est diffusé sur l'exemple de téléviseur (BroadcastService) entre 21h et 21h30 le 12 octobre 2019 :

    BroadcastEvent

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "BroadcastEvent",
      "@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
      "name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
      "description": "Three mice leave the town and the trip turns into something more.",
      "startDate": "2019-10-12T21:00-08:00",
      "endDate": "2019-10-12T21:30-08:00",
      "videoFormat": "HD",
      "isLiveBroadcast": false,
      "publishedOn": {
        "@type": "BroadcastService",
        "@id": "http://example.com/stations/example_tv"
      },
      "workPerformed": {
        "@type": "TVEpisode",
        "@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
      }
    }
    

    Service de diffusion

    {
      "@context":"http://schema.org",
      "@type":"BroadcastService",
      "@id":"http://example.com/stations/example_tv",
      "name":"EXAMPLE-TV",
      "broadcastDisplayName":"ABCD",
      "callSign": "EXA-TV",
      "videoFormat":"SD",
      "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"
       }
      ],
      "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"
            }
          ]
        }
      }
    }
    

    Exemple illustrant l'utilisation de la propriété contentToBeAnnounced lorsque le contenu à diffuser sur le réseau de télévision Example TV (BroadcastService) entre 21h et 21h30 le 12 octobre 2019 n'est pas connu au moment de la création du flux :

    BroadcastEvent

    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "BroadcastEvent",
      "@id": "http://example.com/randomUniqueEventId",
      "name": "To Be Announced"
      "startDate": "2019-10-12T21:00-08:00",
      "endDate": "2019-10-12T21:30-08:00",
      "publishedOn": {
        "@type": "BroadcastService",
        "@id": "http://example.com/stations/example_tv"
      },
      "contentToBeAnnounced": true
    }
    

    Service de diffusion

    {
      "@context":"http://schema.org",
      "@type":"BroadcastService",
      "@id":"http://example.com/stations/example_tv",
      "name":"EXAMPLE-TV",
      "broadcastDisplayName":"ABCD",
      "callSign": "EXA-TV",
      "videoFormat":"SD",
      "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"
       }
      ],
      "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"
            }
          ]
        }
      }
    }
    

    Le réseau de télévision Example TV(BroadcastService) est hors réseau entre 12h et 20h et diffuse 1 émission nommée My favorite show entre 20h et 12h:

    BroadcastEvent

    {
       "@context": ["http://schema.org", {"@language": "en"}],
       "@type": "BroadcastEvent",
       "@id": "http://example.com/randomUniqueEventId1",
       "name": “Off Air”,
       "startDate": "2019-10-12T00:00-08:00",
       "endDate": "2019-10-12T20:00-08:00",
       "publishedOn": {
           "@type": "BroadcastService",
           "@id": "http://example.com/stations/example_tv"
       },
       "offAir": true
    },
    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "BroadcastEvent",
      "@id": "http://example.com/randomUniqueEventId2",
      "startDate": "2019-10-12T20:00-08:00",
      "endDate": "2019-10-13T00:00-08:00",
      "videoFormat": "HD",
      "isLiveBroadcast": false,
      "name": "My favorite show",
      "workPerformed": {
        ...
      },
      "publishedOn": {
        "@type": "BroadcastService",
        "@id": "http://example.com/stations/example_tv"
      },
    
    }
    

    Service de diffusion

    {
      "@context":"http://schema.org",
      "@type":"BroadcastService",
      "@id":"http://example.com/stations/example_tv",
      "name":"EXAMPLE-TV",
      "broadcastDisplayName":"ABCD",
      "callSign": "EXA-TV",
      "videoFormat":"SD",
      "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"
       }
      ],
      "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"
            }
          ]
        }
      }
    }
    

    Consultez les pages suivantes pour les sujets liés à ces propriétés: