Propriétés de balisage de contenu des artistes, albums et chansons

Cette section fournit des informations sur les propriétés de balisage de contenu pour les types d'entités MusicGroup, MusicAlbum et MusicRecording.

Tableau des spécifications

MusicGroup

Propriété Type attendu Description
@context Texte Obligatoire : toujours défini sur ["http://schema.googleapis.com", {"@language": "xx"}].
  • Où "xx" représente la langue des chaînes dans le flux. Le champ @language de chaque contexte d'entité racine doit être défini sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres ou du doublage est l'anglais.
@type Texte Obligatoire : toujours défini sur MusicGroup pour les artistes et les groupes.
@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.
url URL Obligatoire : URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux à celui des bases de données de Google.
url doit répondre aux exigences suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • url doit pointer vers une page de description du contenu qui n'est pas bloquée par un paywall.
Pour le lien profond de la lecture, consultez plutôt la propriété urlTemplate de l'objet target.
name Texte Obligatoire : nom de l'artiste ou du groupe.
potentialAction ListenAction Obligatoire : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez les propriétés de balisage des actions.
subjectOf MusicPlaylist Obligatoire pour les actions basées sur des entités : détails de l'action basée sur des entités.
subjectOf.@type Texte Obligatoire pour les actions basées sur des entités : cette propriété doit toujours être définie sur MusicPlaylist.
subjectOf.@id URL Obligatoire pour les actions basées sur des entités : identifiant de l'action basée sur des entités. Consultez les conditions requises pour @id ci-dessus. Il doit être différent de l'@id de l'artiste ou du groupe.
subjectOf.url URL Obligatoire pour les actions basées sur des entités : URL canonique de l'action basée sur des entités. Consultez les conditions requises pour url ci-dessus. Vous pouvez l'omettre s'il est identique à celui de l'artiste ou du groupe.url
subjectOf.potentialAction ListenAction Obligatoire pour les actions basées sur des entités : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez les propriétés de balisage des actions.
image ImageObject Image représentant le groupe musical. Consultez Propriétés du balisage d'image.
sameAs URL URL d'une page Web de référence permettant d'identifier l'artiste (par exemple, sa page Wikipédia). Cette valeur doit être différente de celle de la propriété url.
description Texte Brève biographie de l'artiste. 300 caractères maximum.
isFamilyFriendly Valeur booléenne Indique si le contenu est adapté à toute la famille (c'est-à-dire s'il convient à tous les membres d'une famille, y compris les enfants). Les produits Google peuvent utiliser isFamilyFriendly pour déterminer le titre à lire.
popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer le contenu multimédia à lire pour les utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. L'échelle du score doit donc être cohérente dans vos flux, pour toutes les entités de votre catalogue. Par défaut, le score de popularité d'une entité est défini sur 0.
popularityScore.@type Texte Toujours défini sur PopularityScoreSpecification.
popularityScore.value Number Valeur numérique non négative indiquant la popularité de l'entité. Plus le score est élevé, plus la popularité est élevée.
popularityScore.eligibleRegion Pays Région(s) où ce score de popularité est applicable. Si le score de popularité est applicable à l'échelle mondiale, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité spécifique à une langue prévaut sur la popularité mondiale (EARTH)

MusicAlbum

Propriété Type attendu Description
@context Texte Obligatoire : toujours défini sur ["http://schema.googleapis.com", {"@language": "xx"}].
  • Où "xx" représente la langue des chaînes dans le flux. Le champ @language de chaque contexte d'entité racine doit être défini sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres ou du doublage est l'anglais.
@type Texte Obligatoire : toujours défini sur MusicAlbum pour les albums.
@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.
url URL Obligatoire : URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux à celui des bases de données de Google.
url doit répondre aux exigences suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • url doit pointer vers une page de description du contenu qui n'est pas bloquée par un paywall.
Pour le lien profond de la lecture, consultez plutôt la propriété urlTemplate de l'objet target.
name Texte Obligatoire : nom de l'album.
byArtist MusicGroup Obligatoire : artiste ou groupe ayant enregistré cet album. Vous devez au moins spécifier l'@id unique que vous utilisez pour cet artiste et son nom. Si l'album est associé à plusieurs artistes, vous pouvez fournir un tableau de valeurs dans byArtist.
byArtist.@type Texte Obligatoire : définissez toujours la valeur sur MusicGroup pour cette propriété.
byArtist.@id URL Obligatoire : identifiant de l'artiste de l'album. Consultez les conditions requises pour @id ci-dessus. Il doit correspondre à l'@id que vous utilisez pour l'artiste/le groupe ailleurs dans votre flux.
byArtist.name Texte Obligatoire : nom de l'artiste ou du groupe.
potentialAction ListenAction Obligatoire : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez les propriétés de balisage des actions.
subjectOf MusicPlaylist Obligatoire pour les actions basées sur des entités : détails de l'action basée sur des entités.
subjectOf.@type Texte Obligatoire pour les actions basées sur des entités : cette propriété doit toujours être définie sur MusicPlaylist.
subjectOf.@id URL Obligatoire pour les actions basées sur des entités : identifiant de l'action basée sur des entités. Consultez les conditions requises pour @id ci-dessus. Il doit être différent de celui de l'album (@id).
subjectOf.url URL Obligatoire pour les actions basées sur des entités : URL canonique de l'action basée sur des entités. Consultez les conditions requises pour url ci-dessus. Vous pouvez l'omettre s'il est identique à url pour l'album.
subjectOf.potentialAction ListenAction Obligatoire pour les actions basées sur des entités : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez les propriétés de balisage des actions.
image ImageObject Image représentant l'album musical. Consultez Propriétés du balisage d'image.
sameAs URL URL d'une page Web de référence permettant d'identifier l'album (par exemple, la page Wikipédia de l'album). Cette valeur doit être différente de celle de la propriété url.
numTracks Entier Nombre de titres sur cet album.
timeRequired Texte Durée de l'album, au format ISO 8601.
description Texte Brève description de l'album. 300 caractères maximum.
isFamilyFriendly Valeur booléenne Indique si le contenu est adapté à toute la famille (c'est-à-dire s'il convient à tous les membres d'une famille, y compris les enfants). Les produits Google peuvent utiliser isFamilyFriendly pour déterminer le titre à lire.
popularityScore PopularityScoreSpecification Score utilisé par Google, ainsi que d'autres signaux, pour déterminer le contenu multimédia à lire pour les utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. L'échelle du score doit donc être cohérente dans vos flux, pour toutes les entités de votre catalogue. Par défaut, le score de popularité d'une entité est défini sur 0.
popularityScore.@type Texte Toujours défini sur PopularityScoreSpecification.
popularityScore.value Number Valeur numérique non négative indiquant la popularité de l'entité. Plus le score est élevé, plus la popularité est élevée.
popularityScore.eligibleRegion Pays Région(s) où ce score de popularité est applicable. Si le score de popularité est applicable à l'échelle mondiale, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.

MusicRecording

Propriété Type attendu Description
@context Texte Obligatoire : toujours défini sur ["http://schema.googleapis.com", {"@language": "xx"}].
  • Où "xx" représente la langue des chaînes dans le flux. Le champ @language de chaque contexte d'entité racine doit être défini sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres ou du doublage est l'anglais.
@type Texte Obligatoire : toujours défini sur MusicRecording pour les titres/pistes.
@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.
url URL Obligatoire : URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux à celui des bases de données de Google.
url doit répondre aux exigences suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • url doit pointer vers une page de description du contenu qui n'est pas bloquée par un paywall.
Pour le lien profond de la lecture, consultez plutôt la propriété urlTemplate de l'objet target.
name Texte Obligatoire : nom du titre.
byArtist MusicGroup Obligatoire : artiste ou groupe ayant enregistré ce titre. Vous devez au moins spécifier l'@id unique que vous utilisez pour cet artiste et son nom. Si le titre est associé à plusieurs artistes, vous pouvez fournir un tableau de valeurs dans byArtist.
byArtist.@type Texte Obligatoire : définissez toujours la valeur sur MusicGroup pour cette propriété.
byArtist.@id URL Obligatoire : identifiant de l'artiste de la chanson. Consultez les conditions requises pour @id ci-dessus. Il doit correspondre à l'@id que vous utilisez pour l'artiste/le groupe ailleurs dans votre flux.
byArtist.name Texte Obligatoire : nom de l'artiste ou du groupe.
potentialAction ListenAction Obligatoire : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez les propriétés de balisage des actions.
subjectOf MusicPlaylist Obligatoire pour les actions basées sur des entités : détails de l'action basée sur des entités
subjectOf.@type Texte Obligatoire pour les actions basées sur des entités : cette propriété doit toujours être définie sur MusicPlaylist.
subjectOf.@id URL Obligatoire pour les actions basées sur des entités : identifiant de l'action basée sur des entités. Consultez les conditions requises pour @id ci-dessus. Il doit être différent de celui indiqué dans le champ @id pour le titre.
subjectOf.url URL Obligatoire pour les actions basées sur des entités : URL canonique de l'action basée sur des entités. Consultez les conditions requises pour url ci-dessus. Vous pouvez l'omettre s'il est identique à url pour le titre.
subjectOf.potentialAction ListenAction Obligatoire pour les actions basées sur des entités : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez les propriétés de balisage des actions.
image ImageObject Image représentant l'enregistrement musical. Consultez Propriétés du balisage d'image.
sameAs URL URL d'une page Web de référence permettant d'identifier l'album (par exemple, la page Wikipédia de l'album). Cette valeur doit être différente de celle de la propriété url.
inAlbum MusicAlbum L'album sur lequel figure le titre, le cas échéant.
inAlbum.@type Texte Cette propriété doit toujours être définie sur MusicAlbum.
inAlbum.@id URL Identifiant de l'album. Consultez les conditions requises pour @id ci-dessus. Il doit correspondre à l'@id que vous utilisez pour l'album ailleurs dans votre flux.
inAlbum.name Texte Nom de l'album.
duration Texte Durée du titre, au format ISO 8601.
description Texte Brève description de la chanson. 300 caractères maximum.
isFamilyFriendly Valeur booléenne Indique si le contenu est adapté à toute la famille (c'est-à-dire s'il convient à tous les membres d'une famille, y compris les enfants). Les produits Google peuvent utiliser isFamilyFriendly pour déterminer le titre à lire.
popularityScore PopularityScoreSpecification Score utilisé par Google, ainsi que d'autres signaux, pour déterminer le contenu multimédia à lire pour les utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. L'échelle du score doit donc être cohérente dans vos flux, pour toutes les entités de votre catalogue. Par défaut, le score de popularité d'une entité est défini sur 0.
popularityScore.@type Texte Toujours défini sur PopularityScoreSpecification.
popularityScore.value Number Valeur numérique non négative indiquant la popularité de l'entité. Plus le score est élevé, plus la popularité est élevée.
popularityScore.eligibleRegion Pays Région(s) où ce score de popularité est applicable. Si le score de popularité est applicable à l'échelle mondiale, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.

Exemples

MusicGroup 

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicGroup",
  "@id":"http://www.example.com/artist/my_favorite_artist/",
  "url":"http://www.example.com/artist/my_favorite_artist/",
  "sameAs": "http://www.my_favorite_artist.com",
  "name":"My Favorite Artist",
  "description":"This is my favorite artist.",
  "image":[
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["US","UK","MX"]
    },
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/artist/my_favortie_artist/1x1/photo2.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["UA", "IR"]
    }
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 92,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "GB"
      }
    ]
  },
  "potentialAction": {
    "@type":"ListenAction",
    "target": {
      "@type":"EntryPoint",
      "urlTemplate":"http://www.example.com/artist/my_favorite_artist?autoplay=true",
      "actionPlatform":[
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleAudioCast",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "expectsAcceptanceOf":{
      "@type":"Offer",
      "category":"subscription",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "subjectOf": {
    "@type":"MusicPlaylist",
    "@id":"http://www.example.com/artist_mix/my_favorite_artist/",
    "url":"http://www.example.com/artist_mix/my_favorite_artist/",
    "name":"My Favorite Artist Mix",
    "description":"A playlist of songs similar to My Favorite Artist",
    "potentialAction":{
      "@type":"ListenAction",
      "target": {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?autoplay=true",
        "actionPlatform":[
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform",
          "http://schema.googleapis.com/GoogleAudioCast",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "expectsAcceptanceOf":{
        "@type":"Offer",
        "category":"free",
        "eligibleRegion": {
          "@type":"Country",
          "name":"US"
        }
      }
    }
  }
}

MusicAlbum 

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicAlbum",
  "@id":"http://www.example.com/album/my_favorite_album",
  "url":"http://www.example.com/album/my_favorite_album",
  "name":"My Favorite Album",
  "sameAs":"https://en.wikipedia.org/wiki/my_favorite_album_(my_favorite_artist_album)",
  "description":"This is my favorite album.",
  "datePublished":"2010-08-24",
  "numTracks":"12",
  "timeRequired":"P44M02S",
  "byArtist":{
    "@type":"MusicGroup",
    "@id": "http://www.example.com/artist/my_favorite_artist/",
    "name":"My Favorite Artist"
  },
  "image":[
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo1.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["US","UK","MX"]
    },
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo2.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["UA", "IR"]
    }
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 87,
    "eligibleRegion": {
        "@type": "Country",
        "name": "US"
    }
  },
  "potentialAction": {
    "@type":"ListenAction",
    "target": {
      "@type":"EntryPoint",
      "urlTemplate":"http://www.example.com/album/my_favorite_album?autoplay=true",
      "actionPlatform":[
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleAudioCast",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "expectsAcceptanceOf":{
      "@type":"Offer",
      "category":"subscription",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "subjectOf": {
    "@type":"MusicPlaylist",
    "@id":"http://www.example.com/album_mix/my_favorite_album",
    "url":"http://www.example.com/album_mix/my_favorite_album",
    "name":"My Favorite Album Mix",
    "description":"A playlist of songs similar to My Favorite Album",
    "potentialAction":{
      "@type":"ListenAction",
      "target": {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/album_mix/my_favorite_album?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform",
          "http://schema.googleapis.com/GoogleAudioCast",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "expectsAcceptanceOf":{
        "@type":"Offer",
        "category":"free",
        "eligibleRegion": {
          "@type":"Country",
          "name":"US"
        }
      }
    }
  }
}

MusicRecording 

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicRecording",
  "@id":"http://www.example.com/track/my_favorite_song",
  "url":"http://www.example.com/track/my_favorite_song",
  "name":"My Favorite Song",
  "sameAs":"https://en.wikipedia.org/wiki/my_favorite_song_(song)",
  "description":"This is my favorite song.",
  "datePublished":"2010-08-24",
  "duration":"PT3M54S",
  "byArtist":{
    "@type":"MusicGroup",
    "@id": "http://www.example.com/artist/my_favorite_song/",
    "name":"My Favorite Artist"
  },
  "inAlbum":{
    "@type":"MusicAlbum",
    "@id":"http://www.example.com/album/my_favorite_album",
    "name":"My Favorite Album"
  },
  "image":[
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo1.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["US","UK","MX"]
    },
    {
      "@type": "ImageObject",
      "contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo2.jpg",
      "dateModified" : "2018-01-05T22:11:33+00:00",
      "regionsAllowed" : ["UA", "IR"]
    }
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 97,
    "eligibleRegion": "EARTH"
  },
  "potentialAction": {
    "@type":"ListenAction",
    "target": {
      "@type":"EntryPoint",
      "urlTemplate":"http://www.example.com/track/my_favorite_song?autoplay=true",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleAudioCast",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "expectsAcceptanceOf": {
      "@type":"Offer",
      "category":"subscription",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "subjectOf": {
    "@type":"MusicPlaylist",
    "@id":"http://www.example.com/track_mix/my_favorite_song",
    "url":"http://www.example.com/track_mix/my_favorite_song",
    "name":"My Favorite Song Mix",
    "description":"A playlist of songs similar to My Favorite Song",
    "potentialAction":{
      "@type":"ListenAction",
      "target": {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/track_mix/my_favorite_song?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/AndroidTVPlatform",
          "http://schema.googleapis.com/GoogleAudioCast",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "expectsAcceptanceOf":{
        "@type":"Offer",
        "category":"free",
        "eligibleRegion": {
          "@type":"Country",
          "name":"US"
        }
      }
    }
  }
}

Consultez les pages suivantes pour en savoir plus sur les thèmes liés à ces propriétés :