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

Cette section décrit en détail les propriétés de balisage du contenu pour le type d'entité MusicPlaylist.

Table 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. Le contexte de chaque entité racine doit être défini sur le code de langue approprié, au format BCP 47. Par exemple, si la langue est l'espagnol, les noms sont considérés comme étant en espagnol, même si la langue du sous-titre est en anglais.
@type Texte Obligatoire : toujours défini sur MusicPlaylist pour les mix.
@id URL Obligatoire : l'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 ne pas changer au fil du temps (même si la propriété de l'URL de l'émission change). Elle est 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é qu'une entité url répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser une url d'entité comme @id. Consultez la section Identifiant pour en savoir plus.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux avec le contenu des bases de données de Google.
url doit répondre aux exigences suivantes :
  • url doit être unique au niveau mondial
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • url doit renvoyer vers une page de description de contenu qui n'est pas bloquée par un paywall.
Pour les liens profonds de lecture, consultez plutôt la propriété urlTemplate de l'objet cible.
name Texte Obligatoire : nom de la playlist, par exemple "Mix Jazz Funky".
genre Texte Obligatoire si la playlist est un mix de genres : liste de mots clés spécifiques au genre représenté par la playlist. La présence de cette propriété indique à Google que vous souhaitez utiliser cette playlist comme un genre.
numTracks Entier Obligatoire si la playlist correspond à un mix : nombre de titres de la playlist. La présence de cette propriété indique à Google que cette playlist est sélectionnée manuellement. L'absence de cette propriété indique que la playlist est une playlist générée automatiquement et sans fin.
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 d'action.
image ImageObject Image de la playlist représentant le contenu de la playlist ou du mix musical. Consultez Propriétés du balisage d'image.
creator Organisation ou personne Recommandé si le créateur est très intéressé. Utilisez cette propriété pour indiquer les playlists créées par votre service (type Organisation avec sa propriété name indiquant votre service) ou un utilisateur qui s'intéresse particulièrement à votre service (par exemple, Personne avec sa propriété name indiquant l'utilisateur qui vous intéresse).
keywords Texte Une liste de mots clés ("rock", "pop"), d'humeurs (heureux" et de moments de détente), d'activités (« exercice », “détente""), ou d'autres termes liés à la playlist.
description Texte Brève description de la playlist. 300 caractères maximum.
isFamilyFriendly Booléen Indique si le contenu est adapté aux familles (s'il est adapté à tous les membres de la famille, y compris aux enfants). Les produits Google peuvent utiliser isFamilyFriendly pour déterminer le titre à lire.
popularityScore PopularitéScoreScore Fortement recommandé Pourquoi ? Score que Google utilise, 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. Par conséquent, l'échelle du score doit être cohérente entre vos flux, parmi 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é. Un score élevé signifie une plus grande popularité.
popularityScore.eligibleRegion Pays Région(s) dans laquelle le niveau de popularité s'applique. Si le niveau de popularité est applicable dans le monde entier, définissez la valeur sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité selon les paramètres régionaux prévaut sur la popularité globale (EARTH)

Exemple

Exemple contenant une playlist composée de titres pop des années 2010 sélectionnés manuellement:

{
  "@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 les sujets liés à ces propriétés: