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

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

Table de spécification 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 : cette valeur est toujours définie sur BroadcastEvent.
@id URL Obligatoire : l'identifiant du contenu au format URI. Par exemple, https://example.com/1234abc.
@id doit répondre aux exigences suivantes :
  • Unique au niveau global dans votre catalogue
  • Statique ; l'identifiant doit être stable et immuable dans le temps (même si la propriété URL est modifiée). Elle est traitée comme une chaîne opaque et ne doit donc pas nécessairement être un lien fonctionnel.
  • Sous la forme d'un URI (Uniform Resource Identifier)
  • 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 durées.
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, n'indiquez pas cet établissement.
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-la sur Movie, TVSeries ou TVEpisode.
workPerformed.@id URL @id de l'entité de contenu.
broadcastOfEvent Événement sportif 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é d'événement. L'entité d'événement doit exister dans le flux et sa @id doit être différente de celle de BroadcastEvent.
videoFormat Texte Définition de qualité la plus élevée acceptée pour ce service de diffusion (
  • "SD" pour une définition standard
  • "HD" pour une vidéo 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 le cas échéant : utilisez cette propriété si le contenu est inconnu au moment de la création du flux.

Définissez-le sur true lorsque le fournisseur ne dispose pas d'informations à jour sur le contenu diffusé (false dans le cas contraire).
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
offAir Booléen Obligatoire le cas échéant : utilisez cette propriété si aucun contenu n'est planifié pour le créneau horaire.
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
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 est diffusé en tant qu'événement de diffusion en direct en tant que 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 diffusion. Pour en savoir plus, consultez la section Propriétés des identifiants.
  • 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 dans les cas où une entité Movie, TVSeries, TVEpisode ou SportsEvent de niveau supérieur 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 les TMS_ID ou TMS_ROOT_ID de l'entité Movie, TVSeries, TVEpisode ou SportsEvent à laquelle vous idéalement faites référence à l'aide de la propriété workPerformed ou broadcastOfEvent.
  • Privilégiez TMS_ID par rapport à la valeur TMS_ROOT_ID.
contentRating Texte ou Note Obligatoire pour les contenus réservés aux adultes, fortement recommandé dans le cas contraire Pourquoi - Classification globale du contenu de diffusion. Si la classification du contenu est définie sous la forme d'une chaîne de texte, deux variantes sont acceptées:
  • L'agence d'évaluation a ajouté un préfixe à la note, avec un espace blanc entre les deux. Par exemple, la classification "MPAA-MP3" pour l'agence américaine "MPAA" aux États-Unis doit être définie comme "MPAA-PG-13". Consultez la liste des agences.
  • La valeur "NOT NOT KNOWN" (non sensible à la casse) indique que vous ne connaissez pas la note du film.
contentRating.author Texte ou Organisation Obligatoire si contentRating utilise Rating : nom de l'organisme d'évaluation.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la note.
contentRating.advisoryCode Texte Code consultatif du contenu. Valeurs acceptées : 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 TV est diffusé sur la chaîne de télévision Example TV (BroadcastService) entre 21 h et 21 h 30 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",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

L'exemple d'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
}

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

Le réseau de télévision Example TV(BroadcastService) est hors air 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"
  },

}

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

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