W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści w przypadku typów elementów MusicGroup
, MusicAlbum
i MusicRecording
.
Tabela specyfikacji
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@context |
Text | Wymagany – zawsze ma wartość ["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type |
Text | Wymagany – zawsze ustawiany 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 identyfikatorów, zalecamy używanie url podmiotu jako @id . Więcej informacji znajdziesz w sekcji Identyfikator. |
url |
Adres URL | Wymagany – kanoniczny adres URL treści, którego Google używa do dopasowywania treści z pliku danych do treści z baz danych Google.url musi spełniać te wymagania:
urlTemplate obiektu docelowego. |
name |
Text | Wymagane – nazwa wykonawcy lub zespołu.
|
potentialAction |
ListenAction (słuchanie) | Wymagany – obiekt oznaczenia działania, który zawiera szczegóły działania. Więcej informacji znajdziesz w właściwościach znaczników akcji.
|
subjectOf |
MusicPlaylist | Wymagany w przypadku działań z wynikiem powiązanym z elementem – szczegóły działania z wynikiem powiązanym z elementem. |
subjectOf.@type |
Text | Wymagany w przypadku działań z użyciem sedna z informacjami o entytatach – w przypadku tej właściwości zawsze ustawiaj wartość MusicPlaylist . |
subjectOf.@id |
Adres URL | Wymagany w przypadku działań zdefiniowanych na podstawie jednostek – identyfikator działania zdefiniowanego na podstawie jednostki. Zapoznaj się z wymaganiami dotyczącymi @id . Musi się różnić od @id dla wykonawcy lub grupy. |
subjectOf.url |
Adres URL | Wymagany w przypadku działań z użyciem elementów: kanoniczny URL działania z użyciem elementów. Zapoznaj się z wymaganiami dotyczącymi url . Możesz pominąć ten element, jeśli jest taki sam jak url dla wykonawcy lub grupy. |
subjectOf.potentialAction |
ListenAction (słuchanie) | Wymagany w przypadku działań z użyciem elementów – obiekt oznaczenia działania, który zawiera szczegóły działania. Więcej informacji znajdziesz w właściwościach znaczników akcji.
|
image |
ImageObject | Obraz reprezentujący grupę muzyczną. Zobacz Właściwości znaczników obrazu. |
sameAs |
Adres URL | Adres URL strony referencyjnej, która może zidentyfikować wykonawcę, np. jego stronę 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ą przyjazne rodzinie (czyli czy są odpowiednie 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 zalecane (dlaczego?) Wynik, który Google używa razem z innymi sygnałami do określania, które multimedia wyświetlać użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w katalogu. Dlatego skala wyniku musi być spójna w przypadku wszystkich plików danych i wszystkich elementów w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0. |
popularityScore.@type |
Text | Zawsze ustawiona na PopularityScoreSpecification . |
popularityScore.value |
Number | Wartość liczbowa większa od zera, która wskazuje popularność elementu. Im wyższa wartość, tym większa popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których obowiązuje ten wynik popularności. Jeśli wynik popularności jest stosowany globalnie, ustaw go na EARTH . Domyślnie ta właściwość jest ustawiona na EARTH . Note: Popularność w danym regionie ma pierwszeństwo przed popularnością globalną (EARTH). |
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 identyfikatorów, zalecamy używanie url podmiotu jako @id . Więcej informacji znajdziesz w sekcji Identyfikator. |
url |
Adres URL | Wymagany – kanoniczny adres URL treści, którego Google używa do dopasowywania treści z pliku danych do treści z baz danych Google.url musi spełniać te wymagania:
urlTemplate obiektu docelowego. |
name |
Text | Wymagany: nazwa albumu.
|
byArtist |
MusicGroup | Wymagane – wykonawca lub grupa, która nagrała ten album. Musisz podać co najmniej unikalny identyfikator @id tego wykonawcy i jego nazwę. Jeśli album jest powiązany z wieloma wykonawcami, możesz podać tablicę wartości w polu byArtist. |
byArtist.@type |
Text | Wymagany – w przypadku tej właściwości zawsze ustawiaj wartość MusicGroup . |
byArtist.@id |
Adres URL | Wymagany – identyfikator wykonawcy albumu. Zapoznaj się z wymaganiami dotyczącymi @id . Musi być zgodny z @id użytym w przypadku wykonawcy lub grupy w innych miejscach w pliku danych. |
byArtist.name |
Text | Wymagany – nazwa wykonawcy lub zespołu. |
potentialAction |
ListenAction (słuchanie) | Wymagany – obiekt oznaczenia działania, który zawiera szczegóły działania. Więcej informacji znajdziesz w właściwościach znaczników akcji.
|
subjectOf |
MusicPlaylist | Wymagany w przypadku działań z wynikiem powiązanym z elementem – szczegóły działania z wynikiem powiązanym z elementem. |
subjectOf.@type |
Text | Wymagany w przypadku działań z użyciem sedna z informacjami o entytatach – w przypadku tej właściwości zawsze ustawiaj wartość MusicPlaylist . |
subjectOf.@id |
Adres URL | Wymagany w przypadku działań zdefiniowanych na podstawie jednostek – identyfikator działania zdefiniowanego na podstawie jednostki. Zapoznaj się z wymaganiami dotyczącymi @id . Musi się różnić od @id albumu. |
subjectOf.url |
Adres URL | Wymagany w przypadku działań z użyciem elementów: kanoniczny URL działania z użyciem elementów. Zapoznaj się z wymaganiami dotyczącymi url . Możesz pominąć ten element, jeśli jest taki sam jak url w albumie. |
subjectOf.potentialAction |
ListenAction (słuchanie) | Wymagany w przypadku działań zdefiniowanych na podstawie typu zasobu – obiekt znaczników działania zawierający szczegóły działania. Więcej informacji znajdziesz w właściwościach znaczników akcji.
|
image |
ImageObject | Obraz reprezentujący album muzyczny. Zobacz Właściwości znaczników obrazu. |
sameAs |
Adres URL | Adres URL strony referencyjnej, która może zidentyfikować album, np. stronę 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 w formacie ISO 8601. |
description |
Text | Krótki opis albumu. Limit 300 znaków.
|
isFamilyFriendly |
Wartość logiczna | Wskazuje, czy te treści są przyjazne dla całej rodziny (czyli czy są odpowiednie dla wszystkich członków rodziny, w tym dzieci). Usługi Google mogą używać isFamilyFriendly do określania utworu do odtworzenia. |
popularityScore |
PopularityScoreSpecification | Wynik, który Google używa razem z innymi sygnałami do określania, które multimedia wyświetlać użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w katalogu. Dlatego skala wyniku musi być spójna w przypadku wszystkich plików danych i wszystkich elementów w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0. |
popularityScore.@type |
Text | Zawsze ustawiona na PopularityScoreSpecification . |
popularityScore.value |
Number | Wartość liczbowa większa od zera, która wskazuje popularność elementu. Im wyższa wartość, tym większa popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których obowiązuje ten wynik popularności. Jeśli wynik popularności jest stosowany globalnie, ustaw go na EARTH . Domyślnie ta właściwość jest ustawiona na EARTH . |
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/ścieżek zawsze ustawiaj 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 identyfikatorów, zalecamy używanie url podmiotu jako @id . Więcej informacji znajdziesz w sekcji Identyfikator. |
url |
Adres URL | Wymagany – kanoniczny adres URL treści, którego Google używa do dopasowywania treści z pliku danych do treści z baz danych Google.url musi spełniać te wymagania:
urlTemplate obiektu docelowego. |
name |
Text | Wymagany – nazwa utworu.
|
byArtist |
MusicGroup | Wymagany: wykonawca lub zespół, który nagrał utwór. Musisz podać co najmniej unikalny identyfikator @id tego wykonawcy i jego nazwę. Jeśli utwór jest powiązany z wieloma wykonawcami, możesz podać tablicę wartości w polu byArtist. |
byArtist.@type |
Text | Wymagany – w przypadku tej właściwości zawsze ustawiaj wartość MusicGroup . |
byArtist.@id |
Adres URL | Wymagany – identyfikator wykonawcy utworu. Zapoznaj się z wymaganiami dotyczącymi @id . Musi być zgodny z @id użytym w przypadku wykonawcy lub grupy w innych miejscach w pliku danych. |
byArtist.name |
Text | Wymagany – nazwa wykonawcy lub zespołu. |
potentialAction |
ListenAction (słuchanie) | Wymagany – obiekt oznaczenia działania, który zawiera szczegóły działania. Więcej informacji znajdziesz w właściwościach znaczników akcji.
|
subjectOf |
MusicPlaylist | Wymagany w przypadku działań z użyciem elementów – szczegóły działania z użyciem elementów. |
subjectOf.@type |
Text | Wymagany w przypadku działań z użyciem sedna z informacjami o entytatach – w przypadku tej właściwości zawsze ustawiaj wartość MusicPlaylist . |
subjectOf.@id |
Adres URL | Wymagany w przypadku działań z użyciem zainicjowania przez jednostkę – identyfikator działania z użyciem zainicjowania przez jednostkę. Zapoznaj się z wymaganiami dotyczącymi @id . Musi się różnić od @id utworu. |
subjectOf.url |
Adres URL | Wymagany w przypadku działań z użyciem elementów: kanoniczny adres URL działania z użyciem elementów. Zapoznaj się z wymaganiami dotyczącymi url . Możesz pominąć ten element, jeśli jest taki sam jak url utworu. |
subjectOf.potentialAction |
ListenAction (słuchanie) | Wymagany w przypadku działań z użyciem elementów – obiekt oznaczenia działania, który zawiera szczegóły działania. Więcej informacji znajdziesz w właściwościach znaczników akcji.
|
image |
ImageObject | Obraz reprezentujący nagranie muzyczne. Zobacz Właściwości znaczników obrazu. |
sameAs |
Adres URL | Adres URL strony referencyjnej, która może zidentyfikować album, np. stronę albumu w Wikipedii. Musi się różnić od właściwości url . |
inAlbum |
MusicAlbum | album, na którym pojawia 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. Zapoznaj się z wymaganiami dotyczącymi @id . Musi być zgodny z @id użytym w albumie w innym miejscu w Twoim kanale. |
inAlbum.name |
Text | Nazwa albumu. |
duration |
Text | Czas trwania utworu w formacie ISO 8601. |
description |
Text | krótki opis utworu; Limit 300 znaków.
|
isFamilyFriendly |
Wartość logiczna | Wskazuje, czy te treści są przyjazne rodzinie (czyli czy są odpowiednie dla wszystkich członków rodziny, w tym dzieci). Usługi Google mogą używać isFamilyFriendly do określania utworu do odtworzenia. |
popularityScore |
PopularityScoreSpecification | Wynik, który Google używa razem z innymi sygnałami do określania, które multimedia wyświetlać użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w katalogu. Dlatego skala wyniku musi być spójna w przypadku wszystkich plików danych i wszystkich elementów w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0. |
popularityScore.@type |
Text | Zawsze ustawiona na PopularityScoreSpecification . |
popularityScore.value |
Number | Wartość liczbowa większa od zera, która wskazuje popularność elementu. Im wyższa wartość, tym większa popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których obowiązuje ten wynik popularności. Jeśli wynik popularności jest stosowany globalnie, ustaw go na EARTH . Domyślnie ta właściwość jest ustawiona na EARTH . |
Przykłady
{
"@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"
}
}
}
}
}
{
"@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"
}
}
}
}
}
{
"@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
Aby dowiedzieć się więcej o tych usługach, zapoznaj się z tymi stronami: