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
MusicGroup
| Właściwość | Oczekiwany typ | Opis | 
|---|---|---|
| @context | Text | Wymagany – zawsze ma wartość ["http://schema.googleapis.com", {"@language": "xx"}].
 | 
| @type | Text | Wymagany – zawsze ustawiany na MusicGroupw przypadku wykonawców i grup. | 
| @id | Adres URL | Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc. @idmusi spełniać te wymagania:
 urlpodmiotu spełnia wszystkie wymagania dotyczące identyfikatorów, zalecamy używanieurlpodmiotu 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. urlmusi spełniać te wymagania:
 urlTemplateobiektu 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@iddla 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 jakurldla 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ć isFamilyFriendlydo 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 naEARTH.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. @idmusi spełniać te wymagania:
 urlpodmiotu spełnia wszystkie wymagania dotyczące identyfikatorów, zalecamy używanieurlpodmiotu 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. urlmusi spełniać te wymagania:
 urlTemplateobiektu docelowego. | 
| name | Text | Wymagany: nazwa albumu. 
 | 
| byArtist | MusicGroup | Wymagane – wykonawca lub grupa, która nagrała ten album. Musisz podać co najmniej unikalny identyfikator @idtego 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@iduż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@idalbumu. | 
| 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 jakurlw 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ć isFamilyFriendlydo 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 naEARTH. | 
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/ścieżek zawsze ustawiaj wartość MusicRecording. | 
| @id | Adres URL | Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc. @idmusi spełniać te wymagania:
 urlpodmiotu spełnia wszystkie wymagania dotyczące identyfikatorów, zalecamy używanieurlpodmiotu 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. urlmusi spełniać te wymagania:
 urlTemplateobiektu docelowego. | 
| name | Text | Wymagany – nazwa utworu. 
 | 
| byArtist | MusicGroup | Wymagany: wykonawca lub zespół, który nagrał utwór. Musisz podać co najmniej unikalny identyfikator @idtego 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@iduż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@idutworu. | 
| 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 jakurlutworu. | 
| 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@iduż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ć isFamilyFriendlydo 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 naEARTH. | 
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
Aby dowiedzieć się więcej o tych usługach, zapoznaj się z tymi stronami: