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

Cette section décrit les propriétés de balisage de contenu pour le type d'entité associé Event.

Tableau des spécifications des événements sportifs

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 SportsEvent.
@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 : nom de cet événement.
  • Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues.
  • Notez qu'un seul nom est accepté par langue (paire langue-pays).
description Texte Description de cet événement. Limiste de 300 caractères. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et longueurs.
sport URL Obligatoire Lien vers la page Wikipédia du sport (en anglais de préférence).
startDate DateTime ou Date Obligatoire : heure de début de l'événement au format ISO 8601 avec fuseau horaire. Veuillez noter qu'il s'agit de l'heure de début réelle de l'événement et non de sa 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 Recommandé Pourquoi ? Équipe locale de l'événement.
homeTeam.name Texte Obligatoire : nom complet de l'équipe sportive.
homeTeam.sport URL Obligatoire Lien vers la page Wikipédia du sport (en anglais de préférence).
homeTeam.sameAs URL Recommandé Pourquoi ? URL vers une page Web de référence pouvant 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 Recommandé Pourquoi ? URL vers une page Web de référence permettant d'identifier la ligue, par exemple, la page Wikipédia de la ligue.
awayTeam SportsTeam Recommandé Pourquoi ? Équipe de reconnaissance de l'événement. Les propriétés sont identiques à SportsEvent.homeTeam.
competitor SportsTeam ou Person Recommandé Pourquoi ? Si vous ne pouvez pas sélectionner l'équipe à domicile ou celle à l'extérieur (par exemple, un match de boxe ou les Jeux olympiques), désignez les participants en tant que concurrents. Si la valeur est SportsTeam, les propriétés sont identiques à SportsEvent.homeTeam. Si la valeur est Person, les propriétés sont identiques aux autres objets Person (un acteur dans Movie, par exemple).
location Lieu OU Ville Lieu de l'événement.
location.name Texte Obligatoire : nom de l'établissement.
location.address PostalAddress Obligatoire si location @type correspond à un lieu : adresse de l'établissement. Ce champ ne doit pas être utilisé si la valeur du champ "location @type" est "Ville".
location.address.streetAddress Texte Adresse postale du lieu.
location.address.addressLocality Texte Ville de l'emplacement.
location.address.addressRegion Texte État de l'établissement.
location.address.postalCode Texte Code postal du lieu.
location.address.addressCountry Texte Pays au format ISO 3166.
image ImageObject Obligatoire pour Google TV : la ou les images associées à l'événement. Il est recommandé d'utiliser l'affiche officielle ou la bannière de l'événement. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec image, consultez Propriétés d'image.
potentialAction WatchAction Obligatoire si applicable : lien profond permettant de lire l'enregistrement de cet événement sportif dans une 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 Recommandé Pourquoi ? - ID externe ou autre qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés de l'identifiant.

Exemples d'événements sportifs

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 : 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 MusicEvent.
@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
  • Sous la forme d'un identifiant de ressource unifié (URI)
É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 : nom de cet événement.
  • Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues.
  • Notez qu'un seul nom est accepté par langue (paire langue-pays).
description Texte Description de l'événement. Limiste de 300 caractères. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et longueurs.
attendee Organization (Organisation) ou Person (Personne) 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 (Organisation) ou Person (Personne) Personne ou organisation qui a écrit une composition, ou compositeur d'une œuvre interprétée lors d'un événement.
performer Organization (Organisation) ou Person (Personne) Obligatoire : artiste présent à l'événement (un présentateur, un musicien, un groupe de musique ou un acteur, par exemple).
subEvent Événement Événement faisant partie de cet événement. Par exemple, une 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 fait partie. Par exemple, un ensemble de spectacles musicaux peut avoir chacun un festival de musique en tant que super-événement.
location Lieu OU Ville Obligatoire : lieu de l'événement.
location.name Texte Obligatoire : nom de l'établissement.
location.address PostalAddress Obligatoire si location @type correspond à un lieu : adresse de l'établissement. N'utilisez pas cette valeur si "location @type" correspond à "Ville".
location.address.streetAddress Texte Adresse postale du lieu.
location.address.addressLocality Texte Ville de l'emplacement.
location.address.addressRegion Texte État de l'établissement.
location.address.postalCode Texte Code postal du lieu.
location.address.addressCountry Texte Pays au format ISO 3166.
workPerformed CreativeWork Œuvre réalisée dans le cadre d'un événement, par exemple une pièce de théâtre réalisée dans un théâtre.

Exemple d'événement 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 de l'événement

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 Event.
@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
  • Sous la forme d'un identifiant de ressource unifié (URI)
É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 : nom de cet événement.
  • Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues.
  • Notez qu'un seul nom est accepté par langue (paire langue-pays).
description Texte Description de l'événement. Limiste de 300 caractères. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et longueurs.
attendee Organization (Organisation) ou Person (Personne) 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, une 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 fait partie. Par exemple, un ensemble de spectacles musicaux peut avoir chacun un festival de musique en tant que super-événement.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Recommandé Pourquoi ? - Un PublicationEvent permet d'indiquer la date de sortie du contenu original (mondiale ou locale) par un éditeur, par exemple la date de sortie du film en salle.

Utilisez également FeaturedEvent pour indiquer que votre service commercialise ce contenu comme original, sélectionné, spécial, etc.

ExclusiveEvent indique que votre service dispose de droits de distribution exclusifs, et indique où et quand.

Pour en savoir plus et obtenir des exemples, consultez la section Exemple.
releasedEvent.@type Texte Obligatoire : assurez-vous de 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 dans laquelle le contenu a été publié.

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

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

Pour PublicationEvent, il s'agit de la date de sortie initiale de cette entité, par exemple la date de sortie en salle du film.

Pour ExclusiveEvent et FeaturedEvent, il s'agit de la date à laquelle l'entité est disponible 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 date limite à laquelle le fournisseur présente l'entité.

Si le contenu est définitivement exclusif ou mis en avant, définissez endDate sur 20 ans à compter de la date actuelle.
releasedEvent.publishedBy Organization (Organisation) ou Person (Personne) Facultatif : l'organisation ou la personne qui a publié cette entité.
location Lieu OU Ville Obligatoire : lieu de l'événement. Notez que vous pouvez fournir Place au niveau City.
location.name Texte Obligatoire : nom de l'établissement.
location.address PostalAddress Obligatoire si location @type correspond à un lieu : adresse de l'établissement. N'utilisez pas ce type de champ si l'attribut "location @type" est défini sur "Ville".
location.address.streetAddress Texte Adresse postale du lieu.
location.address.addressLocality Texte Ville de l'emplacement.
location.address.addressRegion Texte État de l'établissement.
location.address.postalCode Texte Code postal du lieu.
location.address.addressCountry Texte Pays au format ISO 3166.
workPerformed CreativeWork Œuvre réalisée dans le cadre d'un événement, par exemple une pièce de théâtre réalisée dans un théâtre.

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"
  }
}