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

Cette section fournit des détails 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 (et distinct de l'@id de tout BroadcastEvent faisant référence à cet SportsEvent)
  • Statique : l'ID doit être stable et ne pas changer au fil du temps. Elle sera traitée comme une chaîne opaque et n'a pas besoin d'être un lien fonctionnel.
  • Sous la forme d'un URI (Uniform Resource Identifier)
  • Le domaine utilisé pour la valeur @id doit appartenir à votre organisation.
Important : N'incluez pas de propriété url sur SportsEvent ou BroadcastEvent. Fournissez des liens de lecture à l'aide de SportsEvent.potentialAction. 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 (combinaison langue-pays).
description Texte Description de cet événement. 300 caractères maximum. Utilisez un tableau pour inclure des descriptions dans plusieurs langues (une par langue).
sport URL Obligatoire : lien vers la page Wikipédia (de préférence en anglais) du sport.
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 l'heure de diffusion à la télévision.
endDate DateTime ou Date Recommandé : heure de fin prévue de l'événement au format ISO 8601 avec fuseau horaire. Indiquez l'heure de fin prévue si elle est connue. Si l'heure de fin est inconnue, omettez cette propriété plutôt que de fournir une estimation.
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 (de préférence en anglais) 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 de l'équipe.
homeTeam.athlete.name Texte Nom complet de l'athlète.
homeTeam.parentOrganization SportsOrganization Obligatoire : ligue sportive ou organisation dirigeante à laquelle l'équipe appartient. Incluez parentOrganization sur homeTeam et awayTeam lorsque les deux équipes sont fournies.
homeTeam.parentOrganization.name Texte Obligatoire : nom de la ligue sportive à laquelle l'équipe appartient. Par exemple, National Basketball Association ou 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 ? - Un lien vers la page Wikipédia (version anglaise de préférence) qui identifie la ligue de l'équipe (par exemple, https://en.wikipedia.org/wiki/National_Basketball_Association). N'utilisez pas d'URL d'espace réservé example.com.
awayTeam SportsTeam Fortement recommandé Pourquoi ? - L'équipe visiteuse de l'événement. Les propriétés et les exigences (y compris parentOrganization) sont les mêmes que pour SportsEvent.homeTeam.
competitor SportsTeam ou Person Fortement recommandé Pourquoi ? Si les notions d'équipe à domicile ou à l'extérieur ne s'appliquent pas (par exemple, pour un match de boxe ou les Jeux olympiques), indiquez les participants en tant que concurrents. Si SportsTeam, les propriétés sont les mêmes que SportsEvent.homeTeam. Si Person, les propriétés sont les mêmes que pour les autres objets Person (par exemple, un acteur dans Movie).
location Lieu OU Ville Lieu de l'événement.
location.name Texte Obligatoire : nom de l'emplacement.
location.address PostalAddress Obligatoire si le @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'emplacement.
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 : image(s) associée(s) à 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 Propriétés d'image.
potentialAction WatchAction Obligatoire, le cas échéant : liens profonds pour lire l'événement sportif, utilisés à la fois pour les diffusions en direct sans chaîne et les replays de vidéos à la demande. Tous les liens profonds vers des événements sportifs doivent se trouver sur SportsEvent.potentialAction. Ne placez jamais potentialAction sur un BroadcastEvent qui fait référence à un SportsEvent (pour les diffusions de chaînes de TV linéaires sans lien profond direct vers l'événement, fournissez le lien profond vers la chaîne sur BroadcastService.potentialAction). Fournissez un tableau d'objets WatchAction lorsque vous proposez plusieurs flux (par exemple, des flux régionaux, locaux ou distants, ou des diffusions multilingues) ou des fenêtres de rediffusion distinctes pour les événements en direct et les vidéos à la demande.
potentialAction.actionAccessibilityRequirement ActionAccessSpecification Obligatoire si potentialAction est fourni : définit le droit d'accès et le créneau de disponibilité cliquable (availabilityStarts et availabilityEnds) pour chaque WatchAction :
  • Fenêtre de pré-roll (availabilityStarts) : pour les diffusions d'événements sportifs en direct, définissez availabilityStarts au moins 14 jours avant SportsEvent.startDate (availabilityStarts <= SportsEvent.startDate - 14 days) afin que les tuiles des événements à venir puissent s'afficher à l'avance (l'entité de l'événement elle-même peut être diffusée plus près du jour du match, à condition que le code temporel availabilityStarts soit au moins 14 jours avant startDate).
  • Marge de sécurité pour les prolongations (availabilityEnds) : définissez availabilityEnds après SportsEvent.endDate avec une marge de sécurité d'au moins deux à trois heures (availabilityEnds >= SportsEvent.endDate + 2 to 3 hours ou jusqu'à la fin de la fenêtre de rediffusion de la vidéo à la demande) pour éviter que les liens profonds n'expirent pendant les prolongations en direct ou la couverture d'après-match.
Pour en savoir plus, consultez Propriétés de balisage des actions.
identifier PropertyValue Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie cette entité de manière unique. Vous pouvez indiquer plusieurs identifiants. Pour en savoir plus, consultez la section Propriétés de l'identifiant.

Exemples de 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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ]
}

Exemple de chaîne de sports individuels 

{
  "@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",
  "endDate": "2019-07-12T23:30-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 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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ],
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?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-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform"
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "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 URI (Uniform Resource Identifier)
Étant donné que l'élément url d'une entité répond à toutes les exigences d'un identifiant, nous vous recommandons d'utiliser l'élément 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 (combinaison langue-pays).
description Texte Description de l'événement. 300 caractères maximum. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et 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 compositeur d'une œuvre jouée lors d'un événement.
performer Organization ou Person Obligatoire : un artiste participant à l'événement (par exemple, un présentateur, un musicien, un groupe de musique ou un acteur).
subEvent Événement Événement faisant partie de cet événement. Par exemple, un événement de type conférence inclut de nombreuses présentations, chacune d'elles étant un sous-événement de la conférence.
superEvent Événement Événement dont cet événement fait partie. Par exemple, un ensemble de concerts individuels peut avoir un festival de musique comme superEvent.
location Lieu OU Ville Obligatoire : lieu de l'événement.
location.name Texte Obligatoire : nom de l'emplacement.
location.address PostalAddress Obligatoire si le @type de l'emplacement est "Place" : adresse de l'emplacement. Ce champ ne doit pas être utilisé si le @type de l'emplacement est "City".
location.address.streetAddress Texte Adresse postale de l'emplacement.
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 jouée lors d'un événement, par exemple une pièce de théâtre jouée lors d'un 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 de spécification 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 URI (Uniform Resource Identifier)
Étant donné que l'élément url d'une entité répond à toutes les exigences d'un identifiant, nous vous recommandons d'utiliser l'élément 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 (combinaison langue-pays).
description Texte Description de l'événement. 300 caractères maximum. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et 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 type conférence inclut de nombreuses présentations, chacune d'elles étant un sous-événement de la conférence.
superEvent Événement Événement dont cet événement fait partie. Par exemple, un ensemble de concerts individuels peut avoir un festival de musique comme superEvent.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Fortement recommandé Pourquoi ? - PublicationEvent permet de spécifier la date de sortie d'origine (mondiale ou locale) d'un contenu par un éditeur, par exemple la date de sortie d'origine d'un film au cinéma.

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

ExclusiveEvent indique que votre service dispose de droits de diffusion exclusifs, et inclut le lieu et la date.

Pour en savoir plus et voir des exemples, consultez la section "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, cela correspond à la date de sortie initiale de cette entité, par exemple la date de sortie d'un film au cinéma.

Pour ExclusiveEvent et FeaturedEvent, cela correspond à 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 la valeur de endDate sur 20 ans à compter de la date actuelle.
releasedEvent.publishedBy Organization ou Person Facultatif : organisation ou personne ayant publié cette entité.
location Lieu OU Ville Obligatoire : lieu de l'événement. Notez que vous pouvez fournir Place au niveau de City.
location.name Texte Obligatoire : nom de l'emplacement.
location.address PostalAddress Obligatoire si le @type de l'emplacement est "Place" : adresse de l'emplacement. Ne l'utilisez pas si le @type de l'emplacement est "City".
location.address.streetAddress Texte Adresse postale de l'emplacement.
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 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"
  }
}