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 - Imposta sempre su ["http://schema.googleapis.com", {"@language": "xx"}].
  • Dove "xx" rappresenta la lingua delle stringhe nel feed. In ogni contesto di entità principale deve essere impostato il codice @language 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 e del doppiaggio è in inglese.
@type Testo Obbligatorio - Imposta 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
  • Statica; L'ID deve essere stabile e non cambiare nel tempo (anche se la proprietà url del podcast cambia). Verrà trattata come una stringa opaca e non deve essere necessariamente un link funzionante.
  • Sotto forma di URI (Unified Resource Identifier)
  • Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.
Poiché il valore url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare il valore 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 abbinare i contenuti del tuo feed ai contenuti nei database di Google.
url deve soddisfare i seguenti requisiti:
  • url deve essere univoco a livello globale
  • url deve contenere un URL canonico funzionante di cui Google possa eseguire la scansione.
  • url deve indirizzare a una pagina di descrizione dei contenuti non bloccata da un paywall.
Per il link diretto della riproduzione, vedi invece 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 vuoi che questa playlist sia una playlist di genere.
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 infinita generata automaticamente.
potentialAction ListenAction Obbligatorio: un oggetto di markup Azione che fornisce i dettagli dell'azione. Per informazioni dettagliate, consulta le proprietà di markup delle azioni.
image ImageObject Un'immagine della playlist che rappresenta la playlist o il mix musicale. Consulta le proprietà del markup delle immagini.
creator Organization o Person Consigliato se il creator è di grande interesse. Utilizza questa proprietà per indicare le playlist create dal tuo servizio (digitato come Organizzazione con la relativa proprietà name che indica il tuo servizio) o un utente di grande interesse del tuo servizio (digitato come 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", "moody"), attività ("allenamento", "relax") 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. Vedi l'esempio Più regioni e lingue.
isFamilyFriendly Valore booleano Indica se i contenuti sono adatti a tutta la famiglia (ovvero, sono adatti a tutti i membri di una famiglia, bambini inclusi). I prodotti Google potrebbero usare isFamilyFriendly per stabilire un brano da riprodurre.
popularityScore PopularityScoreSpecification Altamente consigliato Perché? 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 in tutti i feed, tra tutte le entità nel catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
popularityScore.@type Testo Imposta sempre su PopularityScoreSpecification.
popularityScore.value Number Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto corrisponde a una maggiore popolarità.
popularityScore.eligibleRegion Paese Regioni in cui è applicabile il 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à specifica per località ha la precedenza sulla popolarità globale (EARTH)

Esempio

Esempio che contiene una playlist selezionata a mano dei 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à: