Proprietà del markup dei contenuti delle playlist musicali

Questa sezione fornisce i dettagli delle proprietà del 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. Il contesto di ogni entità root deve avere l'indirizzo @language impostato sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata su Spagnolo, i nomi si suppongono in spagnolo, anche se la lingua del sottotitolo è in inglese.
@type Testo Obbligatorio: sempre impostato su MusicPlaylist per i mix.
@id URL Obbligatorio: l'identificatore del contenuto in formato URI; ad esempio, https://example.com/1234abc.
@id deve soddisfare i seguenti requisiti:
  • Univoco a livello globale in tutto il tuo catalogo
  • Statico; l'ID deve essere stabile e non cambiare nel tempo (anche se la proprietà dell'URL del programma cambia). Verrà considerato come una stringa opaca e non deve essere 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é l'url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare l'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 nel tuo feed ai contenuti nei database di Google.
url deve soddisfare i seguenti requisiti:
  • Il campo url deve essere univoco a livello globale
  • url deve contenere un URL canonico funzionante che Google può sottoporre a scansione.
  • url deve rimandare a una pagina di descrizione dei contenuti che non sia bloccata da un paywall.
Per il link diretto di riproduzione, consulta invece la proprietà urlTemplate dell'oggetto target.
name Testo Obbligatorio - Il nome della playlist, ad esempio "Divertente 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 la playlist in questione è intenzionale.
numTracks Intero Obbligatorio se la playlist è un mix selezionato: il numero di tracce nella playlist. La presenza di questa proprietà indica a Google che questa playlist è curata a mano. L'assenza di questa proprietà indica che si tratta di una playlist infinita generata automaticamente.
potentialAction ListenAction Obbligatorio: un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per informazioni dettagliate, consulta le proprietà del markup delle azioni.
image ImageObject Un'immagine playlist che rappresenta la playlist o il mix musicale. Consulta la sezione Proprietà del markup delle immagini.
creator Organizzazione o Persona Opzione consigliata se il creator è di forte interesse. Utilizza questa proprietà per indicare le playlist create dal tuo servizio (digitate come Organization (Organizzazione) con la proprietà name che indica il servizio) o un utente con un interesse elevato del servizio (digitate come Person (Persona) con la proprietà name (User) che indica l'utente di interesse.
keywords Testo Un elenco di parole chiave ("rock", "pop"), stati d'animo ("Happy", "moody"), attività ("esercizi", "relax"), o altri termini correlati alla playlist.
description Testo Una breve descrizione della playlist. Limite di 300 caratteri.
isFamilyFriendly Booleano Indica se questi contenuti sono adatti alle famiglie (ovvero sono adatti a tutti i membri di una famiglia, compresi i bambini). I prodotti Google possono utilizzare l'isFamilyFriendly per determinare un brano da riprodurre.
popularityScore Specifica del punteggio di popolarità Vivamente consigliato Perché? Un punteggio utilizzato da Google, oltre ad altri indicatori, per determinare quale media riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto agli altri contenuti del tuo catalogo. Pertanto, la scala del punteggio deve essere coerente tra i tuoi feed, tra tutte le entità nel tuo 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 indica una maggiore popolarità.
popularityScore.eligibleRegion Paese Regioni in cui si applica questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, imposta su EARTH. Per impostazione predefinita, questa proprietà è impostata su EARTH.
Note: La popolarità specifica della località ha la precedenza sulla popolarità globale (EARTH)

Esempio

Esempio che contiene una playlist curata 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."
}

Controlla gli argomenti correlati a queste proprietà nelle pagine seguenti: