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 SportsEvent

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 répondre aux exigences 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é URL de la série 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 uniforme (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é 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 régions 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 Wikipédia (version anglaise de préférence) du sport.
startDate DateTime ou Date Obligatoire : heure de début de l'événement au format ISO 8601 avec le fuseau horaire. Veuillez noter qu'il s'agit de l'heure de début réelle de l'événement, et non de l'heure à laquelle il est diffusé à 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 à domicile de l'événement.
homeTeam.name Texte Obligatoire : nom complet de l'équipe sportive.
homeTeam.sport URL Obligatoire : lien vers la page Wikipédia (version anglaise de préférence) 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 Annotations 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 ? Équipe à l'extérieur de l'événement. Les propriétés sont les mêmes que pour SportsEvent.homeTeam.
competitor SportsTeam ou Person Fortement recommandé Pourquoi ? Si l'équipe à domicile ou à l'extérieur ne s'applique pas (par exemple, pour un match de boxe ou les Jeux olympiques), spécifiez les participants comme concurrents. Si la valeur est SportsTeam, les propriétés sont les mêmes que celles de SportsEvent.homeTeam. Si la valeur est Person, les propriétés sont les mêmes que 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 @type de l'emplacement est "Place" : adresse de l'emplacement. Ne doit pas être utilisé si le @type de l'emplacement est "City"
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 : image(s) associée(s) à l'événement. Il est recommandé qu'il s'agisse de l'affiche ou de la bannière officielle de l'événement. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec image, consultez Propriétés des images.
potentialAction WatchAction Obligatoire, le cas échéant : lien profond qui permet 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 des identifiants.

Exemples SportsEvent

Exemple de sport d'équipe

{
  "@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 de sport individuel

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

SportsEvent avec des restrictions GeoShape

{
  "@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"
    }
  ]
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          http://schema.googleapis.com/GoogleVideoCast
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "free",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform",
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
        },
       "eligibleRegion": [{
          "@type": "GeoShape",
          "@id": "http://example.com/area1",
          "addressCountry": "US",
          "postalCode": [
            "94118",
            "94119"
            ]
          },
          {
          "@type": "GeoShape",
          "@id": "http://example.com/area2",
          "addressCountry": "US",
          "postalCode": [
            "94120",
            "94121"
            ]
          },
        ]
      }
    }
  ]
}

Tableau des spécifications 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 répondre aux exigences suivantes :
  • Unique au niveau mondial dans votre catalogue
  • Statique
  • Sous la forme d'un identifiant de ressource uniforme (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é 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 régions 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 le 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 l'auteur d'une œuvre interprétée lors d'un événement.
performer Organization ou Person Obligatoire : un artiste qui se produit lors de l'événement (par exemple, un présentateur, un musicien, un groupe musical ou un acteur).
subEvent Événement Événement faisant partie de cet événement. Par exemple, un événement de conférence inclut de nombreuses présentations, chacune étant un sous-événement de la conférence.
superEvent Événement Événement dont fait partie cet événement. Par exemple, une collection de performances musicales individuelles 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 @type de l'emplacement est "Place" : adresse de l'emplacement. Cette propriété ne doit pas être utilisée si le @type de l'emplacement est "City".
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 lors d'un TheaterEvent.

Exemple 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 : 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 répondre aux exigences suivantes :
  • Unique au niveau mondial dans votre catalogue
  • Statique
  • Sous la forme d'un identifiant de ressource uniforme (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é 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 régions 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 le 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 inclut de nombreuses présentations, chacune étant un sous-événement de la conférence.
superEvent Événement Événement dont fait partie cet événement. Par exemple, une collection de performances musicales individuelles 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 (mondiale ou locale) d'un contenu par un éditeur, comme la date de sortie en salle d'un film.

De plus, utilisez FeaturedEvent pour indiquer que votre service commercialise ce contenu comme un contenu original, mis en avant, spécial, etc.

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

Pour en savoir plus et obtenir des exemples, consultez la section des exemples.
releasedEvent.@type Texte Obligatoire : veillez à toujours définir cette propriété sur l'une des valeurs suivantes :
  • 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 les 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 un PublicationEvent, il s'agit de la date de sortie initiale de cette entité, par exemple la date à laquelle un film est sorti pour la première fois au cinéma.

Pour ExclusiveEvent et FeaturedEvent, il s'agit de la date de début de l'exclusivité ou de la mise en avant de l'entité.
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 met en avant l'entité.

Si le contenu est exclusif ou mis en avant de manière permanente, 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 @type de l'emplacement est "Place" : adresse de l'emplacement. Cette propriété ne doit pas être utilisée si le @type de lieu est "City".
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 lors d'un 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"
  }
}