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

Cette section décrit en détail 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 d'événements de télévision en direct.

Table de spécifications de 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 respecter les exigences suivantes :
  • Unique au niveau mondial dans votre catalogue
  • Statique : l'identifiant doit être stable et ne pas changer au fil du temps (même si la propriété d'URL de l'émission change). Il sera traité comme une chaîne opaque et ne devra 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é en tant que @id. Pour en savoir plus, consultez la section Identifiant.
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 si applicable : spécifiez l'entité BroadcastService qui diffuse cette émission ou cet événement.

Si le contenu est diffusé sur une chaîne TV, cette propriété est obligatoire. Si le contenu n'est associé à aucune chaîne de télévision, n'indiquez pas cette propriété.
publishedOn.@type Texte Définissez cet élément sur BroadcastService.
publishedOn.@id URL La propriété @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 et TVEpisode.
Nous vous recommandons vivement d'inclure dans une entité BroadcastEvent 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-la sur Movie, TVSeries ou TVEpisode.
workPerformed.@id URL @id de l'entité de contenu.
broadcastOfEvent SportsEvent Obligatoire si applicable : utilisez cette propriété s'il s'agit d'un événement en direct :
  • Pour un événement sportif, cette propriété doit faire référence à une entité SportsEvent.

Il est fortement recommandé qu'une entité BroadcastEvent contienne au moins l'un des éléments suivants:
  • 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 Le @id de l'entité de l'événement L'entité de l'événement doit exister dans le flux et avoir une @id différente de celle de BroadcastEvent.
location Text (Texte) ou Country (Pays) Obligatoire si BroadcastEvent est pour un événement SportsEvent (c'est-à-dire qu'il a la propriété broadcastOfEvent) : pays dans lequel l'événement sportif sous-jacent peut être diffusé. Ce champ peut contenir une liste de pays si plusieurs pays peuvent diffuser l'événement sportif.
videoFormat Texte Définition de la meilleure qualité acceptée par ce service de diffusion (par exemple,
    )
  • "SD" pour une définition standard.
  • "HD" pour une haute définition.
  • "2K" pour une résolution 2K
  • "4K" pour une résolution 4K
  • "8K" pour une résolution 8K
contentToBeAnnounced Valeur booléenne Obligatoire si applicable : utilisez cette propriété si le contenu est inconnu au moment de la création du flux.

Définissez cette propriété sur true si le fournisseur ne dispose pas d'informations à jour sur le contenu à diffuser, 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 si applicable : utilisez cette propriété si aucune diffusion de contenu n'est planifiée pour le créneau horaire.
Nous vous recommandons vivement d'inclure dans une entité BroadcastEvent au moins l'un des éléments suivants :
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced défini sur true
  • offAir défini sur true
isLiveBroadcast Valeur booléenne 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 si applicable : si le contenu est diffusé en tant qu'événement de chaîne sans diffusion en direct (avec contentToBeAnnounced défini sur false ou offAir défini sur false) , utilisez cette propriété pour fournir le lien profond de l'événement.
identifier PropertyValue ID externe qui identifie le contenu de la diffusion. 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 TMS_ID ou TMS_ROOT_ID.
  • Cette propriété ne doit être fournie que pour les cas où une entité Movie, TVSeries, TVEpisode ou SportsEvent de premier niveau complète 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 à laquelle vous devriez idéalement faire référence à l'aide de la propriété workPerformed ou broadcastOfEvent.
  • TMS_ID est préférable à la valeur TMS_ROOT_ID.
contentRating Texte ou Note Obligatoire pour les contenus réservés aux adultes, vivement recommandé dans les autres cas Pourquoi ? : classification globale du contenu diffusé. Si la classification du contenu est indiquée sous la forme d'une chaîne de texte, deux variantes sont acceptées:
  • L'agence de classification a ajouté un espace blanc au début de la note. 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 "NOTE NON CONNUE" (non sensible à la casse) indique que vous ne connaissez pas la classification du film.
contentRating.author Text (Texte) ou Organization (Organisation) Obligatoire si contentRating utilise Rating : nom de l'agence d'évaluation.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la note.
contentRating.advisoryCode Texte Code consultatif du contenu. Les valeurs acceptées sont D, FV, L, S et V. D = Dialogue, FV = Violence dans des scènes fantastiques, L = Langue, S = 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": "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 la chaîne de télévision Example TV(BroadcastService) est hors antenne entre 12h et 20h, et diffuse une é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"
  },

}

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 les sujets liés à ces propriétés: