Propriétés de balisage de contenu des playlists musicales

Cette section fournit les détails des propriétés de balisage de contenu pour le type d'entité MusicPlaylist.

Tableau des spécifications

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 MusicPlaylist pour les mixes.
@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 la playlist, par exemple "Funky Jazz Mix".
genre Texte Obligatoire si la playlist est un mix de genres : liste de mots clés propres au genre représenté par la playlist. La présence de cette propriété indique à Google que vous souhaitez que cette playlist soit un genre musical.
numTracks Entier Obligatoire si la playlist correspond à un mix organisé : nombre de titres de la playlist. La présence de cette propriété indique à Google que cette playlist est sélectionnée manuellement. Si cette propriété n'est pas définie, la playlist est une playlist sans fin générée automatiquement.
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.
image ImageObject Image de playlist représentant la playlist ou le mix musical. Consultez la page Propriétés du balisage d'images.
creator Organisation ou personne Recommandé si le créateur s'intéresse beaucoup. Utilisez cette propriété pour indiquer les playlists créées par votre service (avec la propriété Organisation et sa propriété name indiquant votre service) ou un utilisateur intéressé par votre service (avec la propriété Person et sa propriété name indiquant l'utilisateur qui vous intéresse).
keywords Texte Liste de mots clés ("rock", "pop"), d'humeurs ("heureux", "moyen"), d'activités ("exercice", "relaxant") ou d'autres termes en rapport avec la playlist.
description Texte Brève description de la playlist. 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).

Exemple

Exemple contenant une playlist composée à la main des titres pop des années 2010:

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicPlaylist",
  "@id":"http://www.example.com/playlist/top-pop-songs/",
  "url":"http://www.example.com/playlist/top-pop-songs/",
  "name":"Top Pop Songs of the 2010s",
  "image":[
  {
    "@type": "ImageObject",
    "contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo1.jpg",
    "dateModified" : "2018-01-05T22:11:33+00:00",
    "regionsAllowed" : ["US","UK","MX"]
  },
  {
    "@type": "ImageObject",
    "contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo2.jpg",
    "dateModified" : "2018-01-05T22:11:33+00:00",
    "regionsAllowed" : ["UA", "IR"]
  }],
  "genre": [
     "pop",
     "2010s"
  ],
  "numTracks":"46",
  "potentialAction":{
    "@type":"ListenAction",
    "target":[
      {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/playlist/top-pop-songs?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"
        ]
      },
      {
        "@type": "EntryPoint",
        "urlTemplate": "android-app://com.app.example/playlist/top-pop-songs?autoplay=true",
        "actionPlatform": "http://schema.org/AndroidPlatform"
      }
    ],
    "expectsAcceptanceOf":{
      "@type":"Offer",
      "category":"free",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "creator": {
    "@type": "Organization",
    "name": "example.com"
  },
  "keywords": [
    "pop",
    "Party music"
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description":"Top pop songs from the last decade."
}

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