W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści dla typów elementów MusicGroup, MusicAlbum i MusicRecording.
Tabela specyfikacji
MusicGroup
| Właściwość | Oczekiwany typ | Opis |
|---|---|---|
@context |
Text | Wymagany – zawsze ma wartość ["http://schema.googleapis.com", {"@language": "xx"}].
|
@type |
Text | Wymagany – zawsze ustawiony na MusicGroup w przypadku wykonawców i grup. |
@id |
Adres URL | Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.@id musi spełniać te wymagania:
url podmiotu spełnia wszystkie wymagania dotyczące identyfikatora, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator. |
url |
Adres URL | Wymagany – kanoniczny URL treści, którego Google używa do dopasowywania treści w pliku danych do treści w bazach danych Google.url Musi spełniać te wymagania:
urlTemplate obiektu target. |
name |
Text | Wymagane – nazwa wykonawcy lub grupy.
|
potentialAction |
ListenAction (słuchanie) | Wymagany – obiekt znaczników działania, który zawiera szczegóły działania. Szczegółowe informacje znajdziesz w sekcji Właściwości znaczników działania.
|
subjectOf |
MusicPlaylist | Wymagane w przypadku działań opartych na jednostkach – szczegóły działania opartego na jednostkach. |
subjectOf.@type |
Text | Wymagany w przypadku działań opartych na encjach – w przypadku tej właściwości zawsze ustawiaj wartość MusicPlaylist. |
subjectOf.@id |
Adres URL | Wymagany w przypadku działań opartych na elementach – identyfikator działania opartego na elementach. Wymagania dotyczące @id znajdziesz powyżej. Musi się różnić od @id wykonawcy lub grupy. |
subjectOf.url |
Adres URL | Wymagany w przypadku działań opartych na encjach – kanoniczny URL działania opartego na encjach. Wymagania dotyczące url znajdziesz powyżej. Możesz pominąć ten krok, jeśli jest taki sam jak url wykonawcy lub grupy. |
subjectOf.potentialAction |
ListenAction (słuchanie) | Wymagany w przypadku działań opartych na jednostkach – obiekt znaczników działania, który zawiera szczegóły działania. Szczegółowe informacje znajdziesz w sekcji Właściwości znaczników działania.
|
image |
ImageObject | Obraz reprezentujący grupę muzyczną. Zobacz właściwości znaczników obrazów. |
sameAs |
Adres URL | Adres URL referencyjnej strony internetowej, która może zidentyfikować wykonawcę, np. jego strona w Wikipedii. Musi się różnić od właściwości url. |
description |
Text | Krótka biografia wykonawcy. Limit 300 znaków.
|
isFamilyFriendly |
Wartość logiczna | Wskazuje, czy te treści są odpowiednie dla rodzin (czyli dla wszystkich członków rodziny, w tym dzieci). Usługi Google mogą używać isFamilyFriendly do określania utworu do odtworzenia. |
popularityScore |
PopularityScoreSpecification | Zdecydowanie zalecamy Dlaczego? Ocena, której Google używa wraz z innymi sygnałami, aby określić, które media mają być odtwarzane użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w Twoim katalogu. Skala wyniku musi być spójna we wszystkich plikach danych, wśród wszystkich elementów w Twoim katalogu. Domyślnie ocena popularności elementu jest ustawiona na 0. |
popularityScore.@type |
Text | Zawsze ustawiona na PopularityScoreSpecification. |
popularityScore.value |
Number | Nieujemna wartość liczbowa wskazująca popularność elementu. Im wyższy wynik, tym większa popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których obowiązuje ten wynik popularności. Jeśli ocena popularności ma zastosowanie globalne, ustaw wartość EARTH. Domyślnie ta właściwość jest ustawiona na EARTH. Note: Popularność w danym regionie ma pierwszeństwo przed popularnością globalną (EARTH) |
MusicAlbum
| Właściwość | Oczekiwany typ | Opis |
|---|---|---|
@context |
Text | Wymagany – zawsze ma wartość ["http://schema.googleapis.com", {"@language": "xx"}].
|
@type |
Text | Wymagany – w przypadku albumów zawsze ma wartość MusicAlbum. |
@id |
Adres URL | Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.@id musi spełniać te wymagania:
url podmiotu spełnia wszystkie wymagania dotyczące identyfikatora, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator. |
url |
Adres URL | Wymagany – kanoniczny URL treści, którego Google używa do dopasowywania treści w pliku danych do treści w bazach danych Google.url Musi spełniać te wymagania:
urlTemplate obiektu target. |
name |
Text | Wymagany – nazwa albumu.
|
byArtist |
MusicGroup | Wymagane – wykonawca lub grupa, która nagrała ten album. Musisz podać co najmniej unikalny identyfikator @id używany w przypadku danego wykonawcy oraz jego nazwę. Jeśli album jest powiązany z wieloma wykonawcami, możesz podać tablicę wartości w byArtist. |
byArtist.@type |
Text | Wymagany – w przypadku tej właściwości zawsze ustawiony na MusicGroup. |
byArtist.@id |
Adres URL | Wymagany – identyfikator wykonawcy albumu. Wymagania dotyczące @id znajdziesz powyżej. Musi on być zgodny z @id używanym w przypadku wykonawcy lub grupy w innych miejscach pliku danych. |
byArtist.name |
Text | Wymagany – nazwa wykonawcy lub grupy. |
potentialAction |
ListenAction (słuchanie) | Wymagany – obiekt znaczników działania, który zawiera szczegóły działania. Szczegółowe informacje znajdziesz w sekcji Właściwości znaczników działania.
|
subjectOf |
MusicPlaylist | Wymagane w przypadku działań opartych na jednostkach – szczegóły działania opartego na jednostkach. |
subjectOf.@type |
Text | Wymagany w przypadku działań opartych na encjach – w przypadku tej właściwości zawsze ustawiaj wartość MusicPlaylist. |
subjectOf.@id |
Adres URL | Wymagany w przypadku działań opartych na elementach – identyfikator działania opartego na elementach. Wymagania dotyczące @id znajdziesz powyżej. Musi się różnić od @id albumu. |
subjectOf.url |
Adres URL | Wymagany w przypadku działań opartych na encjach – kanoniczny URL działania opartego na encjach. Wymagania dotyczące url znajdziesz powyżej. Możesz pominąć ten krok, jeśli jest taki sam jak url w przypadku albumu. |
subjectOf.potentialAction |
ListenAction (słuchanie) | Wymagany w przypadku działań opartych na jednostkach – obiekt znaczników działania, który zawiera szczegóły działania. Szczegółowe informacje znajdziesz w sekcji Właściwości znaczników działania.
|
image |
ImageObject | Obraz reprezentujący MusicAlbum. Zobacz właściwości znaczników obrazów. |
sameAs |
Adres URL | Adres URL referencyjnej strony internetowej, która może identyfikować album, np. strona albumu w Wikipedii. Musi się różnić od właściwości url. |
numTracks |
Liczba całkowita | Liczba utworów na tym albumie. |
timeRequired |
Text | Długość albumu podana w formacie ISO 8601. |
description |
Text | Krótki opis albumu. Limit 300 znaków.
|
isFamilyFriendly |
Wartość logiczna | Wskazuje, czy te treści są odpowiednie dla rodzin (czyli dla wszystkich członków rodziny, w tym dzieci). Usługi Google mogą używać isFamilyFriendly do określania utworu do odtworzenia. |
popularityScore |
PopularityScoreSpecification | Ocena, której Google używa wraz z innymi sygnałami, aby określić, które media mają być odtwarzane użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w Twoim katalogu. Skala wyniku musi być spójna we wszystkich plikach danych, wśród wszystkich elementów w Twoim katalogu. Domyślnie ocena popularności elementu jest ustawiona na 0. |
popularityScore.@type |
Text | Zawsze ustawiona na PopularityScoreSpecification. |
popularityScore.value |
Number | Nieujemna wartość liczbowa wskazująca popularność elementu. Im wyższy wynik, tym większa popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których obowiązuje ten wynik popularności. Jeśli ocena popularności ma zastosowanie globalne, ustaw wartość EARTH. Domyślnie ta właściwość jest ustawiona na EARTH. |
MusicRecording
| Właściwość | Oczekiwany typ | Opis |
|---|---|---|
@context |
Text | Wymagany – zawsze ma wartość ["http://schema.googleapis.com", {"@language": "xx"}].
|
@type |
Text | Wymagany – w przypadku utworów zawsze ma wartość MusicRecording. |
@id |
Adres URL | Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.@id musi spełniać te wymagania:
url podmiotu spełnia wszystkie wymagania dotyczące identyfikatora, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator. |
url |
Adres URL | Wymagany – kanoniczny URL treści, którego Google używa do dopasowywania treści w pliku danych do treści w bazach danych Google.url Musi spełniać te wymagania:
urlTemplate obiektu target. |
name |
Text | Wymagany – nazwa utworu.
|
byArtist |
MusicGroup | Wymagany – wykonawca lub grupa, która nagrała ten utwór. Musisz podać co najmniej unikalny identyfikator @id używany w przypadku danego wykonawcy oraz jego nazwę. Jeśli utwór jest powiązany z kilkoma wykonawcami, możesz podać tablicę wartości w byArtist. |
byArtist.@type |
Text | Wymagany – w przypadku tej właściwości zawsze ustawiony na MusicGroup. |
byArtist.@id |
Adres URL | Wymagany – identyfikator wykonawcy utworu. Wymagania dotyczące @id znajdziesz powyżej. Musi on być zgodny z @id używanym w przypadku wykonawcy lub grupy w innych miejscach pliku danych. |
byArtist.name |
Text | Wymagany – nazwa wykonawcy lub grupy. |
potentialAction |
ListenAction (słuchanie) | Wymagany – obiekt znaczników działania, który zawiera szczegóły działania. Szczegółowe informacje znajdziesz w sekcji Właściwości znaczników działania.
|
subjectOf |
MusicPlaylist | Wymagane w przypadku działań opartych na jednostkach – szczegóły działania opartego na jednostkach. |
subjectOf.@type |
Text | Wymagany w przypadku działań opartych na encjach – w przypadku tej właściwości zawsze ustawiaj wartość MusicPlaylist. |
subjectOf.@id |
Adres URL | Wymagany w przypadku działań opartych na elementach – identyfikator działania opartego na elementach. Wymagania dotyczące @id znajdziesz powyżej. Musi się różnić od @id utworu. |
subjectOf.url |
Adres URL | Wymagany w przypadku działań opartych na encjach – kanoniczny URL działania opartego na encjach. Wymagania dotyczące url znajdziesz powyżej. Możesz pominąć ten krok, jeśli jest taki sam jak url utworu. |
subjectOf.potentialAction |
ListenAction (słuchanie) | Wymagany w przypadku działań opartych na jednostkach – obiekt znaczników działania, który zawiera szczegóły działania. Szczegółowe informacje znajdziesz w sekcji Właściwości znaczników działania.
|
image |
ImageObject | Obraz reprezentujący MusicRecording. Zobacz właściwości znaczników obrazów. |
sameAs |
Adres URL | Adres URL referencyjnej strony internetowej, która może identyfikować album, np. strona albumu w Wikipedii. Musi się różnić od właściwości url. |
inAlbum |
MusicAlbum | Album, na którym znajduje się utwór (jeśli taki istnieje). |
inAlbum.@type |
Text | W przypadku tej usługi zawsze ustawiaj wartość MusicAlbum. |
inAlbum.@id |
Adres URL | Identyfikator albumu. Wymagania dotyczące @id znajdziesz powyżej. Musi być zgodny z wartością @id używaną w przypadku albumu w innych miejscach pliku danych. |
inAlbum.name |
Text | Nazwa albumu. |
duration |
Text | Długość utworu podana w formacie ISO 8601. |
description |
Text | Krótki opis utworu. Limit 300 znaków.
|
isFamilyFriendly |
Wartość logiczna | Wskazuje, czy te treści są odpowiednie dla rodzin (czyli dla wszystkich członków rodziny, w tym dzieci). Usługi Google mogą używać isFamilyFriendly do określania utworu do odtworzenia. |
popularityScore |
PopularityScoreSpecification | Ocena, której Google używa wraz z innymi sygnałami, aby określić, które media mają być odtwarzane użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w Twoim katalogu. Skala wyniku musi być spójna we wszystkich plikach danych, wśród wszystkich elementów w Twoim katalogu. Domyślnie ocena popularności elementu jest ustawiona na 0. |
popularityScore.@type |
Text | Zawsze ustawiona na PopularityScoreSpecification. |
popularityScore.value |
Number | Nieujemna wartość liczbowa wskazująca popularność elementu. Im wyższy wynik, tym większa popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których obowiązuje ten wynik popularności. Jeśli ocena popularności ma zastosowanie globalne, ustaw wartość EARTH. Domyślnie ta właściwość jest ustawiona na EARTH. |
Przykłady
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"
}
}
}
}
}
Powiązane artykuły
Tematy związane z tymi usługami znajdziesz na tych stronach: