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

Cette section fournit des informations sur les 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 : 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 MusicPlaylist pour les mix.
@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 la playlist, par exemple "Funky Jazz Mix".
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 que cette playlist soit une playlist de genre.
numTracks Entier Obligatoire si la playlist est un mix personnalisé : nombre de titres dans la playlist. La présence de cette propriété indique à Google que cette playlist est créée manuellement. L'absence de cette propriété indique que la playlist est une playlist générée automatiquement et infinie.
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.
image ImageObject Image de la playlist qui représente la playlist ou le mix musical. Consultez la section Propriétés de balisage des images.
creator Organization ou Person Recommandé si le créateur est très intéressant. Utilisez cette propriété pour indiquer les playlists créées par votre service (de type Organisation, avec la propriété name indiquant votre service) ou un utilisateur très intéressé par votre service (de type Personne, avec la propriété name indiquant l'utilisateur concerné).
keywords Texte Liste de mots clés ("rock", "pop"), d'humeurs ("joyeux", "triste"), d'activités ("exercice", "relaxant") ou d'autres termes liés à 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 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)

Exemple

Exemple de playlist 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."
}

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