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

Cette section fournit les détails des propriétés de balisage de contenu pour le type d'entité BroadcastEvent. Pour mieux comprendre la relation entre ces types, consultez les concepts liés aux événements diffusés en direct.

Table 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 contenu au format URI (par exemple, https://example.com/1234abc).
@id doit remplir les conditions suivantes:
  • Unique au niveau mondial dans votre catalogue
  • Statique ; L'ID doit être stable et immuable dans le temps (même si la propriété d'URL de l'émission change). Elle sera traitée 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 l'attribut 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 à 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 et fuseau horaire.
endDate Date Heure de fin de l'événement au format ISO 8601 et 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, n'indiquez 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 comprenne au moins l'un des types d'entités 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, 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.

Il est vivement recommandé qu'une entité BroadcastEvent comprenne 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 @id de l'entité de l'événement. L'entité de l'événement doit exister dans le flux, et son @id est différent de celui de BroadcastEvent.
location Text (Texte) ou Country (Pays) Obligatoire si BroadcastEvent concerne un SportsEvent, c'est-à-dire qu'il possède la propriété broadcastOfEvent : pays dans lequel l'événement SportsEvent sous-jacent peut être diffusé. Ce champ peut contenir une liste de pays si différents pays peuvent diffuser l'événement SportsEvent.
videoFormat Texte Définition de la plus haute qualité acceptée par ce service de diffusion. par exemple,
  • SD pour la définition standard.
  • "HD" pour la haute définition.
  • "2 K" pour la résolution 2K.
  • "4K" pour la résolution 4K.
  • "8K" pour la résolution 8K.
contentToBeAnnounced Valeur booléenne Obligatoire, le cas échéant : utilisez cette propriété si le contenu n'est pas connu au moment de la création du flux.

Définissez cette propriété sur true lorsque le fournisseur ne dispose pas d'informations à jour sur ce qui sera diffusé, ou sur false dans le cas contraire.
Il est vivement recommandé qu'une entité BroadcastEvent comprenne au moins l'un des éléments suivants :
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced défini sur true
  • offAir défini sur true
offAir Valeur booléenne Obligatoire, le cas échéant : utilisez cette propriété si aucun contenu n'est planifié pour ce créneau horaire.
Il est vivement recommandé qu'une entité BroadcastEvent inclut 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 ce paramètre sur true s'il s'agit d'un événement en direct. comme un événement sportif ou un concert.
potentialAction WatchAction Obligatoire, le cas échéant : Si le contenu est diffusé en tant qu'événement sans diffusion en direct sur une chaîne (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 de TMS_ID ou TMS_ROOT_ID.
  • Cette propriété ne doit être fournie que pour les cas où une entité de premier niveau Movie, TVSeries, TVEpisode ou SportsEvent 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 la valeur TMS_ID ou TMS_ROOT_ID de l'entité Movie, TVSeries, TVEpisode ou SportsEvent à laquelle vous feriez référence à l'aide de la propriété workPerformed ou broadcastOfEvent.
  • TMS_ID est préférable à TMS_ROOT_ID.
contentRating Text ou Rating Obligatoire pour le contenu réservé aux adultes, fortement 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 notation a été ajoutée avant la note par un espace blanc. Par exemple, un "PG-13" note de l'agence "MPAA" aux États-Unis est dénommée "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'agence de classification.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la note.
contentRating.advisoryCode Texte Code de recommandation du contenu. Les valeurs acceptées incluent D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.

Exemples

Un épisode de série télévisée est diffusé sur la chaîne de télévision Example TV. (BroadcastService) le 12 octobre 2019 entre 21h et 21h30 :

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 à diffusée sur la chaîne de télévision Example TV (BroadcastService) entre 21h et 21h30 le 12 octobre 2019 n'est pas connue lors 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"
        }
      ]
    }
  }
}

Chaîne de télévision Example TV(BroadcastService) est hors antenne entre 12h et 20h, et diffuse 1 émission intitulée My favorite show entre 20h et 12 h:

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