W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści w typach MusicGroup
, MusicAlbum
i MusicRecording
.
Tabela specyfikacji
MusicGroup
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@context |
Tekst | Wymagane – zawsze ma wartość ["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type |
Tekst | Wymagany – zawsze ustaw wartość 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 elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu 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 w bazach danych Google.url musi spełniać te wymagania:
urlTemplate obiektu docelowego. |
name |
Tekst | Wymagane – nazwa wykonawcy lub grupy.
|
potentialAction |
ListenAction (słuchanie) | Wymagane – 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łań.
|
subjectOf |
MusicPlaylist | Wymagane w przypadku działań inicjujących element – szczegóły działania początkowego elementu. |
subjectOf.@type |
Tekst | Wymagane w przypadku działań inicjowanych przez jednostkę: dla tej usługi zawsze ustawiona jest wartość MusicPlaylist . |
subjectOf.@id |
Adres URL | Wymagane dla działań inicjowanych przez jednostkę – identyfikator działania zapoczątkowanego elementu. Powyżej znajdziesz wymagania związane z funkcją @id . Musi być inny niż @id w przypadku wykonawcy/grupy. |
subjectOf.url |
Adres URL | Wymagane w przypadku działań inicjowanych przez element – kanoniczny URL działania zapoczątkowanego elementu. Powyżej znajdziesz wymagania związane z funkcją url . Możesz pominąć tę informację, jeśli jest taka sama jak url w przypadku wykonawcy/grupy. |
subjectOf.potentialAction |
ListenAction (słuchanie) | Wymagane dla działań inicjowanych przez jednostkę – 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łań.
|
image |
ImageObject | Obraz przedstawiający grupę muzyczną. Zobacz Właściwości znaczników obrazów. |
sameAs |
Adres URL | Adres URL referencyjnej strony internetowej, która pozwala zidentyfikować wykonawcę. np. jego strony w Wikipedii. Musi się ona różnić od właściwości url . |
description |
Tekst | Krótka biografia wykonawcy. Limit 300 znaków.
|
isFamilyFriendly |
Wartość logiczna | Wskazuje, czy treść jest odpowiednia dla całej rodziny (czyli jest odpowiednia dla wszystkich członków rodziny, w tym dzieci). Usługi Google mogą używać parametru isFamilyFriendly przy określaniu utworu do odtworzenia. |
popularityScore |
PopularityScoreSpecification | Dlaczego warto wybrać Wynik wykorzystywany przez Google, wraz z innymi sygnałami, do określania, które multimedia wyświetlić użytkownikom. Ocena ta określa popularność treści w porównaniu z innymi treściami w Twoim katalogu. dlatego skala wyniku musi być spójna we wszystkich plikach danych i we wszystkich elementach w katalogu. Domyślnie wynik popularności jednostki ma wartość 0. |
popularityScore.@type |
Tekst | Zawsze ustawiona na PopularityScoreSpecification . |
popularityScore.value |
Number | Nieujemna wartość liczbowa wskazująca popularność elementu. wyższy wynik oznacza większą popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których obowiązuje ten wskaźnik popularności. Jeśli wynik popularności ma zastosowanie na całym świecie, ustaw wartość EARTH . Domyślnie ustawiona jest wartość EARTH . Note: Popularność w konkretnym regionie ma pierwszeństwo przed popularnością globalną (ZIEMI) |
MusicAlbum
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@context |
Tekst | Wymagane – zawsze ma wartość ["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type |
Tekst | Wymagane – ta opcja zawsze ma wartość MusicAlbum w przypadku albumów. |
@id |
Adres URL | Wymagany – identyfikator treści w formacie URI; np. https://example.com/1234abc.@id musi spełniać te wymagania:
url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu 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 w bazach danych Google.url musi spełniać te wymagania:
urlTemplate obiektu docelowego. |
name |
Tekst | Wymagany – nazwa albumu.
|
byArtist |
MusicGroup | Wymagany – wykonawca lub grupa, która nagrała ten album. Musisz podać co najmniej unikalny identyfikator @id , którego używasz w przypadku tego wykonawcy, oraz jego nazwę. Jeśli z albumem jest powiązanych kilku wykonawców, możesz podać szereg wartości w polu byArtist. |
byArtist.@type |
Tekst | Wymagane – w tej usłudze zawsze ustawiona jest wartość MusicGroup . |
byArtist.@id |
Adres URL | Wymagany – identyfikator wykonawcy albumu. Powyżej znajdziesz wymagania związane z funkcją @id . Musi on być zgodny z polem @id podanym w przypadku wykonawcy/grupy w innym miejscu w pliku danych. |
byArtist.name |
Tekst | Wymagany – nazwa wykonawcy/grupy. |
potentialAction |
ListenAction (słuchanie) | Wymagane – 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łań.
|
subjectOf |
MusicPlaylist | Wymagane w przypadku działań inicjujących element – szczegóły działania początkowego elementu. |
subjectOf.@type |
Tekst | Wymagane w przypadku działań inicjowanych przez jednostkę: dla tej usługi zawsze ustawiona jest wartość MusicPlaylist . |
subjectOf.@id |
Adres URL | Wymagane dla działań inicjowanych przez jednostkę – identyfikator działania zapoczątkowanego elementu. Powyżej znajdziesz wymagania związane z funkcją @id . Musi on być inny niż @id dla albumu. |
subjectOf.url |
Adres URL | Wymagane w przypadku działań inicjowanych przez element – kanoniczny URL działania zapoczątkowanego elementu. Powyżej znajdziesz wymagania związane z funkcją url . Możesz pominąć tę opcję, jeśli jest taka sama jak url dla tego albumu. |
subjectOf.potentialAction |
ListenAction (słuchanie) | Wymagane dla działań inicjowanych przez jednostkę – 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łań.
|
image |
ImageObject | Obraz przedstawiający album muzyczny. Zobacz Właściwości znaczników obrazów. |
sameAs |
Adres URL | Adres URL referencyjnej strony internetowej, która może zidentyfikować album. na przykład stronę albumu w Wikipedii. Musi się ona różnić od właściwości url . |
numTracks |
Liczba całkowita | Liczba utworów lub utworów z tego albumu. |
timeRequired |
Tekst | Długość albumu w formacie ISO 8601. |
description |
Tekst | Krótki opis albumu. Limit 300 znaków.
|
isFamilyFriendly |
Wartość logiczna | Wskazuje, czy treść jest odpowiednia dla całej rodziny (czyli jest odpowiednia dla wszystkich członków rodziny, w tym dzieci). Usługi Google mogą używać parametru isFamilyFriendly przy określaniu utworu do odtworzenia. |
popularityScore |
PopularityScoreSpecification | Wynik wykorzystywany przez Google, wraz z innymi sygnałami, do określania, które multimedia wyświetlić użytkownikom. Ocena ta określa popularność treści w porównaniu z innymi treściami w Twoim katalogu. dlatego skala wyniku musi być spójna we wszystkich plikach danych i we wszystkich elementach w katalogu. Domyślnie wynik popularności jednostki ma wartość 0. |
popularityScore.@type |
Tekst | Zawsze ustawiona na PopularityScoreSpecification . |
popularityScore.value |
Number | Nieujemna wartość liczbowa wskazująca popularność elementu. wyższy wynik oznacza większą popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których obowiązuje ten wskaźnik popularności. Jeśli wynik popularności ma zastosowanie na całym świecie, ustaw wartość EARTH . Domyślnie ustawiona jest wartość EARTH . |
MusicRecording
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@context |
Tekst | Wymagane – zawsze ma wartość ["http://schema.googleapis.com", {"@language": "xx"}] .
|
@type |
Tekst | Wymagany – w przypadku utworów i utworów zawsze ustawiona jest wartość MusicRecording . |
@id |
Adres URL | Wymagany – identyfikator treści w formacie URI; np. https://example.com/1234abc.@id musi spełniać te wymagania:
url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu 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 w bazach danych Google.url musi spełniać te wymagania:
urlTemplate obiektu docelowego. |
name |
Tekst | Wymagany – tytuł utworu.
|
byArtist |
MusicGroup | Wymagany – wykonawca lub grupa, która nagrała ten utwór. Musisz podać co najmniej unikalny identyfikator @id , którego używasz w przypadku tego wykonawcy, oraz jego nazwę. Jeśli do utworu jest powiązanych kilku wykonawców, możesz podać szereg wartości w kolumnie byArtist. |
byArtist.@type |
Tekst | Wymagane – w tej usłudze zawsze ustawiona jest wartość MusicGroup . |
byArtist.@id |
Adres URL | Wymagany – identyfikator wykonawcy utworu. Powyżej znajdziesz wymagania związane z funkcją @id . Musi on być zgodny z polem @id podanym w przypadku wykonawcy/grupy w innym miejscu w pliku danych. |
byArtist.name |
Tekst | Wymagany – nazwa wykonawcy/grupy. |
potentialAction |
ListenAction (słuchanie) | Wymagane – 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łań.
|
subjectOf |
MusicPlaylist | Wymagany w przypadku działań inicjowanych przez podmiot – szczegóły działania początkowego elementu. |
subjectOf.@type |
Tekst | Wymagane w przypadku działań inicjujących encję – w tej usłudze zawsze ustawiona jest wartość MusicPlaylist . |
subjectOf.@id |
Adres URL | Wymagane dla działań inicjowanych przez jednostkę – identyfikator działania zapoczątkowanego elementu. Powyżej znajdziesz wymagania związane z funkcją @id . Musi on być inny niż @id dla utworu. |
subjectOf.url |
Adres URL | Wymagane w przypadku działań inicjowanych przez element – kanoniczny URL działania zapoczątkowanego elementu. Powyżej znajdziesz wymagania związane z funkcją url . Możesz pominąć ten fragment, jeśli ten sam fragment utworu odnosi się do utworu url . |
subjectOf.potentialAction |
ListenAction (słuchanie) | Wymagane dla działań inicjowanych przez jednostkę – 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łań.
|
image |
ImageObject | Obraz przedstawiający MusicRecording. Zobacz Właściwości znaczników obrazów. |
sameAs |
Adres URL | Adres URL referencyjnej strony internetowej, która może zidentyfikować album. na przykład stronę albumu w Wikipedii. Musi się ona różnić od właściwości url . |
inAlbum |
MusicAlbum | Album, na którym znajduje się utwór (jeśli taki istnieje). |
inAlbum.@type |
Tekst | W tej usłudze zawsze ustawiona jest wartość MusicAlbum . |
inAlbum.@id |
Adres URL | Identyfikator albumu. Powyżej znajdziesz wymagania związane z funkcją @id . Musi on być zgodny z wartością @id , której używasz w przypadku innego albumu w pliku danych. |
inAlbum.name |
Tekst | Nazwa albumu. |
duration |
Tekst | Długość utworu podana w formacie ISO 8601. |
description |
Tekst | Krótki opis utworu. Limit 300 znaków.
|
isFamilyFriendly |
Wartość logiczna | Wskazuje, czy treść jest odpowiednia dla całej rodziny (czyli jest odpowiednia dla wszystkich członków rodziny, w tym dzieci). Usługi Google mogą używać parametru isFamilyFriendly przy określaniu utworu do odtworzenia. |
popularityScore |
PopularityScoreSpecification | Wynik wykorzystywany przez Google, wraz z innymi sygnałami, do określania, które multimedia wyświetlić użytkownikom. Ocena ta określa popularność treści w porównaniu z innymi treściami w Twoim katalogu. dlatego skala wyniku musi być spójna we wszystkich plikach danych i we wszystkich elementach w katalogu. Domyślnie wynik popularności jednostki ma wartość 0. |
popularityScore.@type |
Tekst | Zawsze ustawiona na PopularityScoreSpecification . |
popularityScore.value |
Number | Nieujemna wartość liczbowa wskazująca popularność elementu. wyższy wynik oznacza większą popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których obowiązuje ten wskaźnik popularności. Jeśli wynik popularności ma zastosowanie na całym świecie, ustaw wartość EARTH . Domyślnie ustawiona jest wartość 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
Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami: