Cette page a été traduite par l'API Cloud Translation.

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

Cette section fournit des informations 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 sur les événements LiveTV.

Tableau des spécifications de BroadcastEvent

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : doit toujours être 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 : doit toujours être défini sur `BroadcastEvent`.
`@id`	URL	Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc). `@id` doit respecter les conditions suivantes : Unique dans l'ensemble de votre catalogue Statique : l'ID 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 doit pas nécessairement s'agir d'un lien fonctionnel. Au format 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`. 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. 300 caractères maximum. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et de différentes 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 : indiquez 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 est l'un des types d'entités suivants : `Movie`, `TVSeries` et `TVEpisode`. 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`
`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é 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`	Text ou Country	Obligatoire si BroadcastEvent est destiné à un événement sportif, c'est-à-dire s'il possède la propriété `broadcastOfEvent` : pays dans lequel l'événement sportif sous-jacent peut être diffusé. Ce champ peut être une liste de pays si plusieurs pays peuvent diffuser l'événement sportif.
`videoFormat`	Texte	La définition de la plus haute qualité compatible avec ce service de diffusion (par exemple, "SD" pour "définition standard" "HD" pour "haute définition". "2K" pour la résolution 2K. "4K" pour la résolution 4K. "8K" pour la 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éfinir sur `true` lorsque le fournisseur ne dispose pas d'informations à jour sur ce qui sera diffusé, `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 : utilisez cette propriété si aucun contenu n'est prévu pour la période. 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 cette valeur sur `true` si l'événement est 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 streaming en direct sans 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 diffusé. Pour en savoir plus, consultez la section Propriétés d'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 lorsqu'une entité `Movie`, `TVSeries`, `TVEpisode` ou `SportsEvent` racine entièrement constitué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 l'`TMS_ID` ou l'`TMS_ROOT_ID` de l'entité `Movie`, `TVSeries`, `TVEpisode` ou `SportsEvent` que vous devriez idéalement référencer à l'aide de la propriété `workPerformed` ou `broadcastOfEvent`. `TMS_ID` est préférable à la valeur `TMS_ROOT_ID`.
`contentRating`	Text ou Rating	Obligatoire pour les contenus réservés aux adultes, fortement recommandé dans le cas contraire Pourquoi ? - Classification globale du contenu de la diffusion. 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 est placée avant la note, avec un espace en-tre. Par exemple, une classification "PG-13" attribuée par l'organisme "MPAA" aux États-Unis doit être décrite comme "MPAA PG-13". Consultez la liste des agences. La valeur "RATING NOT KNOWN" (insensible à 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 classification.
`contentRating.advisoryCode`	Texte	Code d'avertissement du contenu. Les valeurs acceptées sont : D, FV, L, S et V. D = Dialogue, FV = Violence fantastique, L = Langue, S = Contenu sexuel, V = Violence.

Exemples

Un épisode de série TV est diffusé sur la chaîne de télévision Exemple 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 télévision Example TV(BroadcastService) n'est pas diffusée entre 12h et 20h et diffuse une émission intitulé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"
        }
      ]
    }
  }
}

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

Tableau des spécifications de BroadcastEvent

Exemples

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

À lire également