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 : doit toujours être défini sur ["http://schema.googleapis.com", {"@language": "xx"}].
  • "xx" représente la langue des chaînes du flux. La valeur @language de chaque contexte d'entité racine doit être définie 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/du doublage est l'anglais.
@type Texte Obligatoire : doit toujours être 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 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.
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 respecter les conditions suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • url doit rediriger vers une page de description de 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 cible.
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 la section Propriétés de balisage d'action.
subjectOf MusicPlaylist Obligatoire pour les actions basées sur des entités : informations sur l'action basée sur des entités.
subjectOf.@type Texte Obligatoire pour les actions générées par 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 distinct de l'@id de l'artiste/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 omettre cette valeur si elle est identique à l'url de l'artiste/du groupe.
subjectOf.potentialAction ListenAction Obligatoire pour les actions générées par des entités : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez la section Propriétés de balisage d'action.
image ImageObject Image représentant le MusicGroup. Consultez la section Propriétés de balisage des images.
sameAs URL URL d'une page Web de référence permettant d'identifier l'artiste (par exemple, sa page Wikipédia). Il doit être distinct 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é aux familles (c'est-à-dire qu'il convient à tous les membres d'une famille, y compris aux enfants). Les produits Google peuvent utiliser isFamilyFriendly pour déterminer le titre à lire.
popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score que Google utilise, ainsi que d'autres signaux, pour déterminer les contenus multimédias à diffuser auprès des utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit ê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 qui indique la popularité de l'entité. Plus le score est élevé, plus l'entité est populaire.
popularityScore.eligibleRegion Pays Région(s) où ce score de popularité s'applique. 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 zone géographique prévaut sur la popularité globale (EARTH)

MusicAlbum

Propriété Type attendu Description
@context Texte Obligatoire : doit toujours être défini sur ["http://schema.googleapis.com", {"@language": "xx"}].
  • "xx" représente la langue des chaînes du flux. La valeur @language de chaque contexte d'entité racine doit être définie 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/du doublage est l'anglais.
@type Texte Obligatoire : doit toujours être défini sur MusicAlbum pour les albums.
@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.
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 respecter les conditions suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • url doit rediriger vers une page de description de 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 cible.
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 : cette propriété doit toujours être définie sur MusicGroup.
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/du groupe.
potentialAction ListenAction Obligatoire : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez la section Propriétés de balisage d'action.
subjectOf MusicPlaylist Obligatoire pour les actions basées sur des entités : informations sur l'action basée sur des entités.
subjectOf.@type Texte Obligatoire pour les actions générées par 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 distinct de l'@id de l'album.
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 omettre cette valeur si elle est identique à url pour l'album.
subjectOf.potentialAction ListenAction Obligatoire pour les actions générées par des entités : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez la section Propriétés de balisage d'action.
image ImageObject Image représentant l'album musical. Consultez la section Propriétés de balisage des images.
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). Il doit être distinct de la propriété url.
numTracks Entier Nombre de titres de 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é aux familles (c'est-à-dire qu'il convient à tous les membres d'une famille, y compris aux enfants). Les produits Google peuvent utiliser isFamilyFriendly pour déterminer le titre à lire.
popularityScore PopularityScoreSpecification Score que Google utilise, ainsi que d'autres signaux, pour déterminer les contenus multimédias à diffuser auprès des utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit ê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 qui indique la popularité de l'entité. Plus le score est élevé, plus l'entité est populaire.
popularityScore.eligibleRegion Pays Région(s) où ce score de popularité s'applique. 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 : doit toujours être défini sur ["http://schema.googleapis.com", {"@language": "xx"}].
  • "xx" représente la langue des chaînes du flux. La valeur @language de chaque contexte d'entité racine doit être définie 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/du doublage est l'anglais.
@type Texte Obligatoire : doit toujours être défini sur MusicRecording pour les titres.
@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.
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 respecter les conditions suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • url doit rediriger vers une page de description de 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 cible.
name Texte Obligatoire : nom du titre.
byArtist MusicGroup Obligatoire : artiste ou groupe qui a enregistré le 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 : cette propriété doit toujours être définie sur MusicGroup.
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/du groupe.
potentialAction ListenAction Obligatoire : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez la section Propriétés de balisage d'action.
subjectOf MusicPlaylist Obligatoire pour les actions basées sur des entités : informations sur l'action basée sur des entités
subjectOf.@type Texte Obligatoire pour les actions générées par 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 distinct de l'@id du 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 omettre cette valeur si elle est identique à celle de url pour le titre.
subjectOf.potentialAction ListenAction Obligatoire pour les actions générées par des entités : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez la section Propriétés de balisage d'action.
image ImageObject Image représentant le MusicRecording. Consultez la section Propriétés de balisage des images.
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). Il doit être distinct de la propriété url.
inAlbum MusicAlbum Album sur lequel le titre apparaît, le cas échéant.
inAlbum.@type Texte Cette propriété est toujours 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 du titre. 300 caractères maximum.
isFamilyFriendly Valeur booléenne Indique si le contenu est adapté aux familles (c'est-à-dire qu'il convient à tous les membres d'une famille, y compris aux enfants). Les produits Google peuvent utiliser isFamilyFriendly pour déterminer le titre à lire.
popularityScore PopularityScoreSpecification Score que Google utilise, ainsi que d'autres signaux, pour déterminer les contenus multimédias à diffuser auprès des utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit ê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 qui indique la popularité de l'entité. Plus le score est élevé, plus l'entité est populaire.
popularityScore.eligibleRegion Pays Région(s) où ce score de popularité s'applique. 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"
        }
      }
    }
  }
}

Pour en savoir plus sur ces propriétés, consultez les pages suivantes: