Proprietà di markup dei contenuti delle playlist musicali

Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per il tipo di entità MusicPlaylist.

Tabella delle specifiche

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio: impostato sempre su ["http://schema.googleapis.com", {"@language": "xx"}].
  • dove "xx" rappresenta la lingua delle stringhe nel feed. Per ogni contesto dell'entità principale, l'attributo @language deve essere impostato sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, si presume che i nomi siano in spagnolo anche se la lingua dei sottotitoli/doppiaggio è l'inglese.
@type Testo Obbligatorio: impostato sempre su MusicPlaylist per i mix.
@id URL Obbligatorio: l'identificatore dei contenuti in formato URI, ad esempio https://example.com/1234abc.
@id deve soddisfare i seguenti requisiti:
  • Univoco a livello globale nel tuo catalogo
  • Statico: l'ID deve essere stabile e non cambiare nel tempo (anche se la proprietà url del programma cambia). Verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante.
  • Sotto forma di URI (Uniform Resource Identifier)
  • Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.
Poiché il url di un'entità soddisfa tutti i requisiti di un identificatore, ti consigliamo di utilizzare il url di un'entità come @id. Per ulteriori dettagli, consulta la sezione Identificatore.
url URL Obbligatorio: l'URL canonico dei contenuti, che Google utilizza per associare i contenuti del tuo feed a quelli dei database di Google.
url deve soddisfare i seguenti requisiti:
  • url deve essere univoco a livello globale
  • url deve contenere un URL canonico funzionante che Google può eseguire la scansione.
  • url deve puntare a una pagina di descrizione dei contenuti non bloccata da un paywall.
Per il link diretto per la riproduzione, consulta la proprietà urlTemplate dell'oggetto target.
name Testo Obbligatorio: il nome della playlist, ad esempio "Funky Jazz Mix".
genre Testo Obbligatorio se la playlist è un mix di generi: un elenco di parole chiave specifiche per il genere rappresentato dalla playlist. La presenza di questa proprietà indica a Google che intendi che questa playlist sia una playlist di generi.
numTracks Intero Obbligatorio se la playlist è un mix selezionato: il numero di tracce nella playlist. La presenza di questa proprietà indica a Google che la playlist è selezionata manualmente. L'assenza di questa proprietà indica che la playlist è una playlist generata automaticamente senza fine.
potentialAction ListenAction Obbligatorio: un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per maggiori dettagli, consulta le proprietà di markup delle azioni.
image ImageObject Un'immagine della playlist che la rappresenta o il mix di brani. Consulta la sezione Proprietà di markup delle immagini.
creator Organization o Person Opzione consigliata se il creator è di grande interesse. Utilizza questa proprietà per indicare le playlist create dal tuo servizio (digitando Organization con la relativa proprietà name che indica il tuo servizio) o un utente di grande interesse per il tuo servizio (digitando Person con la relativa proprietà name che indica l'utente di interesse).
keywords Testo Un elenco di parole chiave ("rock", "pop"), stati d'animo ("felice", "malinconico"), attività ("esercizio fisico", "rilassamento") o altri termini correlati alla playlist.
description Testo Una breve descrizione della playlist. Limite di 300 caratteri.
  • Utilizza un array per eseguire il markup della descrizione in più lingue. Consulta l'esempio Più regioni e lingue.
isFamilyFriendly Valore booleano Indica se i contenuti sono adatti alle famiglie (ovvero sono adatti a tutti i membri di una famiglia, compresi i bambini). I prodotti Google potrebbero utilizzare isFamilyFriendly per determinare un brano da riprodurre.
popularityScore PopularityScoreSpecification Molto consigliato Perché? Un punteggio utilizzato da Google, insieme ad altri indicatori, per determinare quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto ad altri contenuti del tuo catalogo. Pertanto, la scala del punteggio deve essere coerente nei tuoi feed e tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
popularityScore.@type Testo Deve essere sempre impostato su PopularityScoreSpecification.
popularityScore.value Number Un valore numerico non negativo che indica la popolarità dell'entità. Un punteggio più alto indica una maggiore popolarità.
popularityScore.eligibleRegion Paese Regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, impostalo su EARTH. Per impostazione predefinita, questa proprietà è impostata su EARTH.
Note: La popolarità a livello di località ha la precedenza sulla popolarità a livello globale (EARTH)

Esempio

Esempio che contiene una playlist selezionata di brani pop degli anni 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."
}

Consulta le seguenti pagine per gli argomenti relativi a queste proprietà: