Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per i tipi di entità MusicGroup, MusicAlbum e MusicRecording.
Tabella delle specifiche
MusicGroup
| Proprietà | Tipo previsto | Descrizione |
|---|---|---|
@context |
Testo | Obbligatorio: sempre impostato su ["http://schema.googleapis.com", {"@language": "xx"}].
|
@type |
Testo | Obbligatorio: impostalo sempre su MusicGroup per artisti e gruppi. |
@id |
URL | Obbligatorio: l'identificatore dei contenuti in formato URI, ad esempio https://example.com/1234abc.@id deve soddisfare i seguenti requisiti:
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 del tuo feed a quelli dei database di Google.url deve soddisfare i seguenti requisiti:
urlTemplate dell'oggetto target. |
name |
Testo | Obbligatorio: il nome dell'artista o del gruppo.
|
potentialAction |
ListenAction | Obbligatorio: un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per maggiori dettagli, consulta le proprietà del markup delle azioni.
|
subjectOf |
MusicPlaylist | Obbligatorio per le azioni basate su entità: dettagli dell'azione basata su entità. |
subjectOf.@type |
Testo | Obbligatorio per le azioni basate su entità: imposta sempre questa proprietà su MusicPlaylist. |
subjectOf.@id |
URL | Obbligatorio per le azioni basate su entità: l'identificatore dell'azione basata su entità. Consulta i requisiti per @id riportati sopra. Deve essere diverso dal @id dell'artista/gruppo. |
subjectOf.url |
URL | Obbligatorio per le azioni basate su entità: l'URL canonico per l'azione basata su entità. Consulta i requisiti per url riportati sopra. Puoi ometterlo se è uguale a url per l'artista/il gruppo. |
subjectOf.potentialAction |
ListenAction | Obbligatorio per le azioni basate su entità: un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per maggiori dettagli, consulta le proprietà del markup delle azioni.
|
image |
ImageObject | Immagine che rappresenta il gruppo musicale. Consulta Proprietà del markup delle immagini. |
sameAs |
URL | Un URL a una pagina web di riferimento che può identificare l'artista, ad esempio la pagina di Wikipedia dell'artista. Deve essere diverso dalla proprietà url. |
description |
Testo | Una breve biografia dell'artista. Limite di 300 caratteri.
|
isFamilyFriendly |
Valore 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 potrebbero utilizzare isFamilyFriendly per determinare un brano da riprodurre. |
popularityScore |
PopularityScoreSpecification | Consigliato vivamente Perché? Un punteggio che Google utilizza, 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, tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0. |
popularityScore.@type |
Testo | 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 | Regione o 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à specifica per località ha la precedenza su quella globale (TERRA) |
MusicAlbum
| Proprietà | Tipo previsto | Descrizione |
|---|---|---|
@context |
Testo | Obbligatorio: sempre impostato su ["http://schema.googleapis.com", {"@language": "xx"}].
|
@type |
Testo | Obbligatorio: sempre impostato su MusicAlbum per gli album. |
@id |
URL | Obbligatorio: l'identificatore dei contenuti in formato URI, ad esempio https://example.com/1234abc.@id deve soddisfare i seguenti requisiti:
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 del tuo feed a quelli dei database di Google.url deve soddisfare i seguenti requisiti:
urlTemplate dell'oggetto target. |
name |
Testo | Obbligatorio: il nome dell'album.
|
byArtist |
MusicGroup | Obbligatorio: l'artista o il gruppo che ha registrato questo album. Come minimo, devi specificare l'@id univoco che utilizzi per l'artista e il suo nome. Se l'album ha più artisti associati, puoi fornire un array di valori in byArtist. |
byArtist.@type |
Testo | Obbligatorio: imposta sempre questo valore su MusicGroup per questa proprietà. |
byArtist.@id |
URL | Obbligatorio: l'identificatore dell'artista dell'album. Consulta i requisiti per @id riportati sopra. Deve corrispondere a @id che utilizzi per l'artista/il gruppo in altre parti del feed. |
byArtist.name |
Testo | Obbligatorio: il nome dell'artista/gruppo. |
potentialAction |
ListenAction | Obbligatorio: un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per maggiori dettagli, consulta le proprietà del markup delle azioni.
|
subjectOf |
MusicPlaylist | Obbligatorio per le azioni basate su entità: dettagli dell'azione basata su entità. |
subjectOf.@type |
Testo | Obbligatorio per le azioni basate su entità: imposta sempre questa proprietà su MusicPlaylist. |
subjectOf.@id |
URL | Obbligatorio per le azioni basate su entità: l'identificatore dell'azione basata su entità. Consulta i requisiti per @id riportati sopra. Deve essere diverso dal @id dell'album. |
subjectOf.url |
URL | Obbligatorio per le azioni basate su entità: l'URL canonico per l'azione basata su entità. Consulta i requisiti per url riportati sopra. Puoi ometterlo se è uguale a url dell'album. |
subjectOf.potentialAction |
ListenAction | Obbligatorio per le azioni basate su entità: un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per maggiori dettagli, consulta le proprietà del markup delle azioni.
|
image |
ImageObject | Immagine che rappresenta MusicAlbum. Consulta Proprietà del markup delle immagini. |
sameAs |
URL | Un URL di una pagina web di riferimento che può identificare l'album, ad esempio la pagina di Wikipedia dell'album. Deve essere diverso dalla proprietà url. |
numTracks |
Intero | Il numero di brani o tracce di questo album. |
timeRequired |
Testo | La durata dell'album, in formato ISO 8601. |
description |
Testo | Una breve descrizione dell'album. Limite di 300 caratteri.
|
isFamilyFriendly |
Valore 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 potrebbero utilizzare isFamilyFriendly per determinare un brano da riprodurre. |
popularityScore |
PopularityScoreSpecification | Un punteggio che Google utilizza, 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, tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0. |
popularityScore.@type |
Testo | 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 | Regione o 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. |
MusicRecording
| Proprietà | Tipo previsto | Descrizione |
|---|---|---|
@context |
Testo | Obbligatorio: sempre impostato su ["http://schema.googleapis.com", {"@language": "xx"}].
|
@type |
Testo | Obbligatorio: sempre impostato su MusicRecording per brani/tracce. |
@id |
URL | Obbligatorio: l'identificatore dei contenuti in formato URI, ad esempio https://example.com/1234abc.@id deve soddisfare i seguenti requisiti:
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 del tuo feed a quelli dei database di Google.url deve soddisfare i seguenti requisiti:
urlTemplate dell'oggetto target. |
name |
Testo | Obbligatorio: il nome del brano.
|
byArtist |
MusicGroup | Obbligatorio: l'artista o il gruppo che ha registrato questo brano. Come minimo, devi specificare l'@id univoco che utilizzi per l'artista e il suo nome. Se il brano ha più artisti associati, puoi fornire un array di valori in byArtist. |
byArtist.@type |
Testo | Obbligatorio: imposta sempre questo valore su MusicGroup per questa proprietà. |
byArtist.@id |
URL | Obbligatorio: l'identificatore dell'artista del brano. Consulta i requisiti per @id riportati sopra. Deve corrispondere a @id che utilizzi per l'artista/il gruppo in altre parti del feed. |
byArtist.name |
Testo | Obbligatorio: il nome dell'artista/gruppo. |
potentialAction |
ListenAction | Obbligatorio: un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per maggiori dettagli, consulta le proprietà del markup delle azioni.
|
subjectOf |
MusicPlaylist | Obbligatorio per le azioni basate su entità: dettagli per l'azione basata su entità |
subjectOf.@type |
Testo | Obbligatorio per le azioni basate su entità: imposta sempre questa proprietà su MusicPlaylist. |
subjectOf.@id |
URL | Obbligatorio per le azioni basate su entità: l'identificatore dell'azione basata su entità. Consulta i requisiti per @id riportati sopra. Deve essere diverso dal @id del brano. |
subjectOf.url |
URL | Obbligatorio per le azioni basate su entità: l'URL canonico per l'azione basata su entità. Consulta i requisiti per url riportati sopra. Puoi ometterlo se è uguale a url per il brano. |
subjectOf.potentialAction |
ListenAction | Obbligatorio per le azioni basate su entità: un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per maggiori dettagli, consulta le proprietà del markup delle azioni.
|
image |
ImageObject | Immagine che rappresenta MusicRecording. Consulta Proprietà del markup delle immagini. |
sameAs |
URL | Un URL di una pagina web di riferimento che può identificare l'album, ad esempio la pagina di Wikipedia dell'album. Deve essere diverso dalla proprietà url. |
inAlbum |
MusicAlbum | L'album in cui appare la traccia, se presente. |
inAlbum.@type |
Testo | Impostato sempre su MusicAlbum per questa proprietà. |
inAlbum.@id |
URL | L'identificatore dell'album. Consulta i requisiti per @id riportati sopra. Deve corrispondere al @id che utilizzi per l'album altrove nel feed. |
inAlbum.name |
Testo | Il nome dell'album. |
duration |
Testo | La durata del brano, in formato ISO 8601. |
description |
Testo | Una breve descrizione del brano. Limite di 300 caratteri.
|
isFamilyFriendly |
Valore 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 potrebbero utilizzare isFamilyFriendly per determinare un brano da riprodurre. |
popularityScore |
PopularityScoreSpecification | Un punteggio che Google utilizza, 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, tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0. |
popularityScore.@type |
Testo | 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 | Regione o 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. |
Esempi
MusicGroup
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicGroup",
"@id":"http://www.example.com/artist/my_favorite_artist/",
"url":"http://www.example.com/artist/my_favorite_artist/",
"sameAs": "http://www.my_favorite_artist.com",
"name":"My Favorite Artist",
"description":"This is my favorite artist.",
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/artist/my_favortie_artist/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 92,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/artist/my_favorite_artist?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/artist_mix/my_favorite_artist/",
"url":"http://www.example.com/artist_mix/my_favorite_artist/",
"name":"My Favorite Artist Mix",
"description":"A playlist of songs similar to My Favorite Artist",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
MusicAlbum
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicAlbum",
"@id":"http://www.example.com/album/my_favorite_album",
"url":"http://www.example.com/album/my_favorite_album",
"name":"My Favorite Album",
"sameAs":"https://en.wikipedia.org/wiki/my_favorite_album_(my_favorite_artist_album)",
"description":"This is my favorite album.",
"datePublished":"2010-08-24",
"numTracks":"12",
"timeRequired":"P44M02S",
"byArtist":{
"@type":"MusicGroup",
"@id": "http://www.example.com/artist/my_favorite_artist/",
"name":"My Favorite Artist"
},
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 87,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/album/my_favorite_album?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/album_mix/my_favorite_album",
"url":"http://www.example.com/album_mix/my_favorite_album",
"name":"My Favorite Album Mix",
"description":"A playlist of songs similar to My Favorite Album",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/album_mix/my_favorite_album?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
MusicRecording
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicRecording",
"@id":"http://www.example.com/track/my_favorite_song",
"url":"http://www.example.com/track/my_favorite_song",
"name":"My Favorite Song",
"sameAs":"https://en.wikipedia.org/wiki/my_favorite_song_(song)",
"description":"This is my favorite song.",
"datePublished":"2010-08-24",
"duration":"PT3M54S",
"byArtist":{
"@type":"MusicGroup",
"@id": "http://www.example.com/artist/my_favorite_song/",
"name":"My Favorite Artist"
},
"inAlbum":{
"@type":"MusicAlbum",
"@id":"http://www.example.com/album/my_favorite_album",
"name":"My Favorite Album"
},
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 97,
"eligibleRegion": "EARTH"
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/track/my_favorite_song?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"
]
},
"expectsAcceptanceOf": {
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/track_mix/my_favorite_song",
"url":"http://www.example.com/track_mix/my_favorite_song",
"name":"My Favorite Song Mix",
"description":"A playlist of songs similar to My Favorite Song",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/track_mix/my_favorite_song?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
Pagine correlate
Consulta le seguenti pagine per gli argomenti correlati a queste proprietà: