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

Cette section fournit des informations détaillées 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 du flux. La balise @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 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 remplir les conditions 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é d'URL de l'émission 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 unifié (URI)
  • Le domaine utilisé pour la valeur @id doit appartenir à votre organisation.
Étant donné que le url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser l'attribut url d'une entité en tant que @id. Pour en savoir plus, consultez la section Identifiant.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données.
url doit respecter les exigences suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • url doit renvoyer 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 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 les propriétés du balisage des actions.
subjectOf MusicPlaylist Requis pour les actions basées sur des entités : détails concernant l'action alimentée par des entités.
subjectOf.@type Texte Requis pour les actions associées à des entités : toujours défini sur MusicPlaylist pour cette propriété.
subjectOf.@id URL Requis pour les actions basées sur des entités : identifiant de l'action alimentée par des entités. Consultez les conditions requises pour @id ci-dessus. Il doit être différent de @id pour l'artiste/le groupe.
subjectOf.url URL Requis pour les actions associées à des entités : URL canonique de l'action associée à des entités. Consultez les conditions requises pour url ci-dessus. Vous pouvez l'omettre s'il est identique à url pour l'artiste/le groupe.
subjectOf.potentialAction ListenAction Requis pour les actions associées à 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 du balisage des actions.
image ImageObject Image représentant MusicGroup. Consultez la page Propriétés du balisage d'images.
sameAs URL URL d'une page Web de référence qui peut identifier l'artiste. par exemple, la page Wikipédia de l'artiste. Elle doit être distincte 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 s'il est adapté à tous les membres d'une famille, y compris aux enfants. Les produits Google peuvent utiliser isFamilyFriendly pour choisir un titre à jouer.
popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau 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é. un score élevé signifie une popularité plus élevée.
popularityScore.eligibleRegion Pays Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité spécifique aux paramètres régionaux a priorité sur la popularité globale (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 du flux. La balise @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 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 remplir les conditions 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é d'URL de l'émission 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 unifié (URI)
  • Le domaine utilisé pour la valeur @id doit appartenir à votre organisation.
Étant donné que le url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser l'attribut url d'une entité en tant que @id. Pour en savoir plus, consultez la section Identifiant.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données.
url doit respecter les exigences suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • url doit renvoyer 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 cible.
name Texte Obligatoire : nom de l'album.
byArtist MusicGroup Obligatoire : Artiste ou groupe qui a enregistré cet album. Vous devez au moins spécifier la valeur @id unique que vous utilisez pour l'artiste en question, ainsi que son nom. Si l'album est associé à plusieurs artistes, vous pouvez fournir un tableau de valeurs dans byArtist.
byArtist.@type Texte Obligatoire : toujours défini 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. Elle doit correspondre à l'@id que vous utilisez pour l'artiste/le groupe figurant 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 du balisage des actions.
subjectOf MusicPlaylist Requis pour les actions basées sur des entités : détails concernant l'action alimentée par des entités.
subjectOf.@type Texte Requis pour les actions associées à des entités : toujours défini sur MusicPlaylist pour cette propriété.
subjectOf.@id URL Requis pour les actions basées sur des entités : identifiant de l'action alimentée par des entités. Consultez les conditions requises pour @id ci-dessus. Il doit être différent du @id de l'album.
subjectOf.url URL Requis pour les actions associées à des entités : URL canonique de l'action associée à des entités. Consultez les conditions requises pour url ci-dessus. Vous pouvez l'omettre si elle est identique à la valeur url de l'album.
subjectOf.potentialAction ListenAction Requis pour les actions associées à 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 du balisage des actions.
image ImageObject Image représentant l'album Music. Consultez la page Propriétés du balisage d'images.
sameAs URL URL d'une page Web de référence pouvant identifier l'album. par exemple, la page Wikipédia de l'album. Elle doit être distincte de la propriété url.
numTracks Entier Nombre de titres ou 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 s'il est adapté à tous les membres d'une famille, y compris aux enfants. Les produits Google peuvent utiliser isFamilyFriendly pour choisir un titre à jouer.
popularityScore PopularityScoreSpecification Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau 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é. un score élevé signifie une popularité plus élevée.
popularityScore.eligibleRegion Pays Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, 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 du flux. La balise @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 est l'anglais.
@type Texte Obligatoire : toujours défini sur MusicRecording pour les titres/titres.
@id URL Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).
@id doit remplir les conditions 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é d'URL de l'émission 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 unifié (URI)
  • Le domaine utilisé pour la valeur @id doit appartenir à votre organisation.
Étant donné que le url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser l'attribut url d'une entité en tant que @id. Pour en savoir plus, consultez la section Identifiant.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données.
url doit respecter les exigences suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • url doit renvoyer 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 cible.
name Texte Obligatoire : nom du titre.
byArtist MusicGroup Obligatoire : artiste ou groupe qui a enregistré le titre. Vous devez au moins spécifier la valeur @id unique que vous utilisez pour l'artiste en question, ainsi que son nom. Si le titre est associé à plusieurs artistes, vous pouvez fournir un ensemble de valeurs dans "byArtist".
byArtist.@type Texte Obligatoire : toujours défini sur MusicGroup pour cette propriété.
byArtist.@id URL Obligatoire : identifiant de l'artiste du titre. Consultez les conditions requises pour @id ci-dessus. Elle doit correspondre à l'@id que vous utilisez pour l'artiste/le groupe figurant 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 du balisage des actions.
subjectOf MusicPlaylist Obligatoire pour les actions associées à des entités : détails concernant l'action alimentée par des entités
subjectOf.@type Texte Requis pour les actions associées à des entités : toujours défini sur MusicPlaylist pour cette propriété.
subjectOf.@id URL Requis pour les actions basées sur des entités : identifiant de l'action alimentée par des entités. Consultez les conditions requises pour @id ci-dessus. Il doit être différent de l'élément @id du titre.
subjectOf.url URL Requis pour les actions associées à des entités : URL canonique de l'action associée à des entités. Consultez les conditions requises pour url ci-dessus. Vous pouvez l'omettre s'il est identique au url du titre.
subjectOf.potentialAction ListenAction Requis pour les actions associées à 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 du balisage des actions.
image ImageObject Image représentant l'élément MusicRecording. Consultez la page Propriétés du balisage d'images.
sameAs URL URL d'une page Web de référence pouvant identifier l'album. par exemple, la page Wikipédia de l'album. Elle doit être distincte de la propriété url.
inAlbum MusicAlbum Album contenant le titre, le cas échéant
inAlbum.@type Texte Toujours défini sur MusicAlbum pour cette propriété.
inAlbum.@id URL Identifiant de l'album. Consultez les conditions requises pour @id ci-dessus. Elle doit correspondre au @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 s'il est adapté à tous les membres d'une famille, y compris aux enfants. Les produits Google peuvent utiliser isFamilyFriendly pour choisir un titre à jouer.
popularityScore PopularityScoreSpecification Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau 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é. un score élevé signifie une popularité plus élevée.
popularityScore.eligibleRegion Pays Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, 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 sujets liés à ces propriétés: