Propriétés de balisage de contenu des événements

Cette section fournit des informations sur les propriétés de balisage de contenu pour le type d'entité associé à Event.

Tableau des spécifications de SportsEvent

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 SportsEvent.
@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 : nom de l'événement.
  • Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs pays et langues.
  • Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
description Texte Description de cet événement. 300 caractères maximum. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et de différentes longueurs.
sport URL Obligatoire : lien vers la page Wikipedia (version anglaise recommandée) du sport.
startDate DateTime ou Date Obligatoire : heure de début de l'événement au format ISO 8601 avec fuseau horaire. Notez qu'il s'agit de l'heure de début réelle de l'événement, et non de l'heure de diffusion à la télévision.
endDate DateTime ou Date Heure de fin de l'événement au format ISO 8601 avec fuseau horaire.
homeTeam SportsTeam Fortement recommandé Pourquoi ? Équipe hôte de l'événement.
homeTeam.name Texte Obligatoire : nom complet de l'équipe sportive.
homeTeam.sport URL Obligatoire : lien vers la page Wikipedia (version anglaise recommandée) du sport.
homeTeam.sameAs URL Fortement recommandé Pourquoi ? URL d'une page Web de référence permettant d'identifier l'équipe (par exemple, la page Wikipédia de l'équipe).
homeTeam.athlete Personne Annotation(s) pour un athlète individuel de l'équipe.
homeTeam.athlete.name Texte Nom complet de l'athlète.
homeTeam.parentOrganization.name SportsOrganization Obligatoire : nom de la ligue sportive à laquelle appartient l'équipe. (par exemple, la National Basketball Association ou la Major League Baseball). Notez que ce champ ne doit pas être utilisé pour la conférence de l'équipe.
homeTeam.parentOrganization.sameAs URL Fortement recommandé Pourquoi ? URL d'une page Web de référence permettant d'identifier la ligue de l'équipe (par exemple, la page Wikipédia de la ligue).
awayTeam SportsTeam Fortement recommandé Pourquoi ? L'équipe visiteuse de l'événement. Les propriétés sont identiques à celles de SportsEvent.homeTeam.
competitor SportsTeam ou Person Fortement recommandé Pourquoi ? Si l'équipe à domicile ou à l'extérieur n'est pas applicable (par exemple, un match de boxe ou les Jeux olympiques), indiquez les participants comme concurrents. Si l'argument est défini sur SportsTeam, les propriétés sont identiques à celles de SportsEvent.homeTeam. Si la valeur est Person, les propriétés sont identiques à celles des autres objets Person, par exemple un acteur dans Movie.
location Établissement OU Ville Lieu de l'événement.
location.name Texte Obligatoire : nom de l'emplacement.
location.address PostalAddress Obligatoire si le type d'emplacement @type est "Place" : adresse de l'emplacement. Cette valeur ne doit pas être utilisée si le type d'emplacement est "Ville".
location.address.streetAddress Texte Adresse postale de l'établissement.
location.address.addressLocality Texte Ville de l'établissement.
location.address.addressRegion Texte État du lieu.
location.address.postalCode Texte Code postal du lieu.
location.address.addressCountry Texte Pays au format ISO 3166.
image ImageObject Obligatoire pour Google TV : une ou plusieurs images associées à l'événement. Il est recommandé d'utiliser l'affiche ou la bannière officielle de l'événement. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec image, consultez la section Propriétés des images.
potentialAction WatchAction Obligatoire si applicable : lien profond permettant de lire l'enregistrement de cet événement sportif en vidéo à la demande. Pour spécifier le lien profond d'un événement en direct, utilisez plutôt la propriété publishedOn ou potentialAction dans BroadcastEvent.
identifier PropertyValue Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie clairement cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés d'identifiant.

Exemples de SportsEvent

Exemple 1 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

Exemple 2 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "sport":"https://en.wikipedia.org/wiki/Boxing"
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

Tableau des spécifications de MusicEvent

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 MusicEvent.
@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
  • Au format URI (Uniform Resource Identifier)
É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 : nom de cet événement.
  • Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs pays et langues.
  • Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
description Texte Description de l'événement. 300 caractères maximum. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et de différentes longueurs.
attendee Organization ou Person Personne ou organisation participant à l'événement.
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.
composer Organization ou Person Personne ou organisation qui a écrit une composition ou qui est le compositeur d'une œuvre interprétée lors d'un événement.
performer Organization ou Person Obligatoire : artiste participant à l'événement (présentateur, musicien, groupe musical ou acteur, par exemple).
subEvent Événement Événement faisant partie de cet événement. Par exemple, un événement de conférence comprend de nombreuses présentations, chacune étant un sous-événement de la conférence.
superEvent Événement Événement auquel cet événement appartient. Par exemple, une collection de spectacles musicaux individuels peut avoir un festival de musique comme super-événement.
location Établissement OU Ville Obligatoire : lieu de l'événement.
location.name Texte Obligatoire : nom de l'emplacement.
location.address PostalAddress Obligatoire si le type d'emplacement @type est "Place" : adresse de l'emplacement. Cette valeur ne doit pas être utilisée si le type d'emplacement @type est "Ville".
location.address.streetAddress Texte Adresse postale de l'établissement.
location.address.addressLocality Texte Ville de l'établissement.
location.address.addressRegion Texte État du lieu.
location.address.postalCode Texte Code postal du lieu.
location.address.addressCountry Texte Pays au format ISO 3166.
workPerformed CreativeWork Une œuvre jouée lors d'un événement, par exemple une pièce de théâtre jouée dans un événement TheaterEvent.

Exemple de MusicEvent

MusicEvent 

{
  "@context":"http://schema.org",
  "@type":"MusicEvent",
  "@id": "http://example.com/music/my_favortie_artist/2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
  "startDate": "2014-10-12T21:10-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "performer": {
    "@type":"Person",
    "name":"My Favorite Artist",
    "birthDate":"1977-02-24",
    "gender":"F",
    "nationality":"CA"
  }
}

Tableau des spécifications des événements

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 Event.
@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
  • Au format URI (Uniform Resource Identifier)
É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 : nom de l'événement.
  • Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs pays et langues.
  • Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
description Texte Description de l'événement. 300 caractères maximum. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et de différentes longueurs.
attendee Organization ou Person Personne ou organisation participant à l'événement.
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.
subEvent Événement Événement faisant partie de cet événement. Par exemple, un événement de conférence comprend de nombreuses présentations, chacune étant un sous-événement de la conférence.
superEvent Événement Événement auquel cet événement appartient. Par exemple, une collection de spectacles musicaux individuels peut avoir un festival de musique comme super-événement.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Fortement recommandé Pourquoi ? - PublicationEvent permet de spécifier la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme la date de sortie initiale d'un film.

En outre, utilisez FeaturedEvent pour indiquer que votre service commercialise ce contenu en tant que contenu original, mis en avant, spécial, etc.

ExclusiveEvent indique que votre service dispose de droits de distribution exclusifs et inclut l'endroit et la date.

Pour en savoir plus et obtenir des exemples, consultez la section d'exemples.
releasedEvent.@type Texte Obligatoire : veillez à toujours définir cette propriété sur l'un des éléments suivants :
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Pays Obligatoire : régions associées à cet événement.

Pour un PublicationEvent, il s'agit de la région où le contenu a été publié.

Pour FeaturedEvent et ExclusiveEvent, il s'agit de la région où le contenu est mis en avant ou exclusif.

Utilisez des codes ISO 3166 pour les pays. Pour indiquer le monde entier, définissez la valeur sur EARTH.
releasedEvent.startDate Date ou DateTime Recommandé : Obligatoire pour ExclusiveEvent : date de début de la publication de l'entité.

Pour PublicationEvent, cette valeur indique la date de sortie initiale de l'entité, par exemple la date de sortie d'un film en salles.

Pour ExclusiveEvent et FeaturedEvent, cette valeur indique la date de début de la période pendant laquelle l'entité est exclusive ou mise en avant.
releasedEvent.endDate Date ou DateTime Recommandé : Obligatoire pour ExclusiveEvent : ne s'applique qu'aux types ExclusiveEvent et FeaturedEvent.

Pour ExclusiveEvent, il s'agit de la date d'expiration des droits sur le contenu.

Pour FeaturedEvent, il s'agit de la dernière date à laquelle le fournisseur a présenté l'entité.

Si le contenu est toujours exclusif ou présenté, définissez endDate sur 20 ans à compter de la date actuelle.
releasedEvent.publishedBy Organization ou Person Facultatif : organisation ou personne ayant publié cette entité.
location Établissement OU Ville Obligatoire : lieu de l'événement. Notez que vous pouvez fournir Place au niveau City.
location.name Texte Obligatoire : nom de l'emplacement.
location.address PostalAddress Obligatoire si le type d'emplacement @type est "Place" : adresse de l'emplacement. Cette valeur ne doit pas être utilisée si le type de lieu est "Ville".
location.address.streetAddress Texte Adresse postale de l'établissement.
location.address.addressLocality Texte Ville de l'établissement.
location.address.addressRegion Texte État du lieu.
location.address.postalCode Texte Code postal du lieu.
location.address.addressCountry Texte Pays au format ISO 3166.
workPerformed CreativeWork Une œuvre jouée lors d'un événement, par exemple une pièce de théâtre jouée dans un événement TheaterEvent.

Exemple d'événement

Événement 

{
  "@context":"http://schema.org",
  "@type":"Event",
  "@id": "http://example.com/keynote/google_io_2019",
  "name":"Google I/O 2019 keynote",
  "description":"Google’s annual developer conference keynote event.",
  "startDate": "2019-05-07T10:00-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "attendee": {
    "@type":"Person",
    "name":"My Favorite Speaker",
    "birthDate":"1971-12-02",
    "gender":"F",
    "nationality":"IN"
  }
}