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

Cette section fournit des informations détaillées sur les propriétés de balisage de contenu pour le type d'entité BroadcastEvent. Pour mieux comprendre la relation entre ces types, consultez les concepts Événements LiveTV.

Tableau de spécification 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 créneau de diffusion au format URI, par exemple https://example.com/live/channel1/20191012T2100.
@id doit respecter les exigences suivantes :
  • Unique au monde dans votre catalogue et distinct de workPerformed.@id ou broadcastOfEvent.@id (par exemple, en intégrant la chaîne/le service et l'heure de début de la diffusion dans l'URI)
  • Statique : l'ID doit être stable et ne pas changer au fil du temps. Elle sera traitée comme une chaîne opaque et n'a pas besoin d'être un lien fonctionnel.
  • Sous la forme d'un URI (Uniform Resource Identifier)
  • Le domaine utilisé pour la valeur @id doit appartenir à votre organisation.
Important : N'incluez pas de propriété url sur BroadcastEvent ou SportsEvent. Indiquez l'élément url canonique uniquement sur l'entité de contenu sous-jacente (Movie, TVSeries ou TVEpisode). Pour en savoir plus, consultez la section Identifiant.
name Texte Obligatoire : titre de l'émission ou de l'événement.
description Texte Description du spectacle ou de l'événement. 300 caractères maximum. Utilisez un tableau pour inclure des descriptions dans plusieurs langues (une par langue).
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 cette émission ou cet é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, le cas échéant : utilisez cette propriété lorsque le contenu correspond à l'un des types d'entités suivants : Movie, TVSeries et TVEpisode.
Il est vivement recommandé qu'une entité BroadcastEvent inclue au moins l'un des éléments suivants :
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced défini sur true
  • offAir défini sur true
workPerformed.@type Texte Définissez-le sur Movie, TVSeries ou TVEpisode.
workPerformed.@id URL @id de l'entité de contenu.
broadcastOfEvent SportsEvent Obligatoire, le cas échéant : 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.

Nous vous recommandons vivement d'inclure au moins l'un des éléments suivants dans une entité BroadcastEvent :
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced défini sur true
  • offAir défini sur true
broadcastOfEvent.@type Texte Définissez cet élément sur SportsEvent.
broadcastOfEvent.@id URL @id de l'entité d'événement. L'entité d'événement doit exister dans le flux et avoir un @id différent de celui de BroadcastEvent.
location Texte ou Pays Obligatoire si BroadcastEvent concerne un SportsEvent, c'est-à-dire s'il possède la propriété broadcastOfEvent : pays dans lequel le SportsEvent sous-jacent peut être diffusé. Ce champ peut être une liste de pays si plusieurs pays peuvent diffuser l'événement sportif.
videoFormat Texte Définition de la plus haute qualité compatible avec ce service de diffusion, par exemple :
  • "SD" pour la définition standard.
  • "HD" pour la haute définition.
  • "2K" pour une résolution 2K.
  • "4K" pour la résolution 4K.
  • "8K" pour une résolution 8K.
contentToBeAnnounced Valeur booléenne Obligatoire, le cas échéant : utilisez cette propriété si le contenu est inconnu au moment de la création du flux.

Définissez la valeur sur true lorsque le fournisseur ne dispose pas d'informations à jour sur ce qui sera diffusé, ou sur false dans le cas contraire.
Nous vous recommandons vivement d'inclure au moins l'un des éléments suivants dans une entité BroadcastEvent :
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced défini sur true
  • offAir défini sur true
offAir Valeur booléenne Obligatoire, le cas échéant : définissez la valeur sur true lorsqu'aucun contenu n'est prévu pour le créneau horaire sur une chaîne BroadcastService.
  • Définissez name et description sur "Off Air".
  • Chaque BroadcastEvent offAir doit durer quatre heures ou moins (ne pas émettre de blocs continus de 24 heures). Lorsqu'une chaîne n'est pas diffusée pendant plus de quatre heures, émettez plusieurs entités BroadcastEvent contiguës qui ne se chevauchent pas, d'une durée maximale de quatre heures chacune, afin que la chaîne conserve une couverture complète 24h/24, 7j/7, sans interruption au début ou à la fin de la fenêtre du flux.
Nous vous recommandons vivement d'inclure au moins l'un des éléments suivants dans une entité BroadcastEvent :
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced défini sur true
  • offAir défini sur true
isLiveBroadcast Valeur booléenne Définissez la valeur booléenne true (sans guillemets) si cette diffusion est en direct (par exemple, un match de sport ou un journal télévisé en direct), ou false pour les programmes non diffusés en direct et les rediffusions.
potentialAction WatchAction Obligatoire, le cas échéant : ne fournissez jamais potentialAction sur un BroadcastEvent lorsque broadcastOfEvent fait référence à un SportsEvent (placez tous les liens profonds de sport sur SportsEvent.potentialAction) ou lorsque publishedOn fait référence à une chaîne BroadcastService (placez les liens profonds de chaîne sur BroadcastService.potentialAction). Ne fournissez BroadcastEvent.potentialAction que pour les diffusions en direct sans chaîne qui ne font pas référence à un SportsEvent (par exemple, un contenu supplémentaire en direct autonome avec contentToBeAnnounced et offAir omis ou false).
identifier PropertyValue ID externe qui identifie le contenu diffusé. Pour en savoir plus, consultez la section Propriétés de l'identifiant.
  • Remarque : Le type d'entité BroadcastEvent n'accepte que les valeurs propertyID de TMS_ID ou TMS_ROOT_ID.
  • Cette propriété ne doit être fournie que lorsqu'une entité Movie, TVSeries, TVEpisode ou SportsEvent de premier niveau entièrement formée n'est pas référencée à l'aide de la propriété workPerformed ou broadcastOfEvent.
  • La valeur de la propriété doit refléter le TMS_ID ou le TMS_ROOT_ID de l'entité Movie, TVSeries, TVEpisode ou SportsEvent que vous référenceriez idéalement à l'aide de la propriété workPerformed ou broadcastOfEvent.
  • TMS_ID est privilégié par rapport à la valeur TMS_ROOT_ID.
contentRating Texte ou Note Obligatoire pour le contenu réservé aux adultes, vivement recommandé pour les autres contenus Pourquoi ? - Classification globale du contenu diffusé. Si la classification du contenu est fournie sous la forme d'une chaîne de texte, deux variantes sont acceptées :
  • L'agence de notation est ajoutée avant la note, séparée par un espace. Par exemple, une classification "PG-13" de l'agence "MPAA" aux États-Unis doit être décrite comme "MPAA PG-13". Consultez la liste des agences.
  • La valeur "RATING NOT KNOWN" (non sensible à la casse) pour indiquer que vous ne connaissez pas la classification du film.
contentRating.author Entreprise Obligatoire si contentRating utilise Rating : nom de l'organisme de classification.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la note.
contentRating.advisoryCode Texte Code de l'avertissement pour le contenu. Les valeurs acceptées sont D, FV, L, S et V. D = Dialogue, FV = Fantasy Violence (violence fantastique), L = Language (langage), S = Sexual Content (contenu à caractère sexuel), V = Violence.

Exemples

Un épisode de série TV est diffusé sur la chaîne de télévision Example TV (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"
  }
}

BroadcastService

{
  "@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",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Exemple illustrant l'utilisation de la propriété contentToBeAnnounced lorsque le contenu à diffuser sur la chaîne 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": "Content To Be Announced",
  "description": "Content 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
}

BroadcastService

{
  "@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",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

La chaîne de télévision Example TV (BroadcastService) est hors antenne entre 12h et 20h (modélisée sous la forme de deux blocs Off Air contigus de quatre heures) et diffuse une émission intitulée My favorite show entre 20h et minuit :

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId1",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T12:00-08:00",
  "endDate": "2019-10-12T16: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",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T16: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/randomUniqueEventId3",
  "name": "My favorite show",
  "description": "Evening broadcast of My favorite show.",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/tv_series/my_favorite_show"
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  }
}

BroadcastService

{
  "@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",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Consultez les pages suivantes pour en savoir plus sur les sujets liés à ces propriétés :