Właściwości playlist muzycznych

W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści typu elementu MusicPlaylist.

Tabela specyfikacji

Właściwość Oczekiwany typ Opis
@context Tekst Wymagane – zawsze ma wartość ["http://schema.googleapis.com", {"@language": "xx"}].
  • Gdzie „xx” odpowiada językowi ciągów znaków w pliku danych. W przypadku każdego kontekstu elementu głównego parametr @language powinien być ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, przyjmuje się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów lub dubbingu jest w języku angielskim.
@type Tekst Wymagane – w przypadku składanek zawsze ustaw wartość MusicPlaylist.
@id Adres URL Wymagany – identyfikator treści w formacie URI; np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Produkt unikalny w całym katalogu
  • statyczny; Identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmienia się właściwość URL programu). Zostanie on potraktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W formacie URI (Unified Resource Identifier)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Atrybut 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:
  • Pole url musi być unikalne globalnie
  • Plik url musi zawierać działający kanoniczny URL, który Google może zindeksować.
  • url musi wskazywać stronę z opisem treści, która nie jest blokowana przez paywall.
W przypadku precyzyjnego linku odtwarzania zapoznaj się z właściwością urlTemplate obiektu docelowego.
name Tekst Wymagany – nazwa playlisty, na przykład „Funky Jazz Mix”.
genre Tekst Wymagany, jeśli playlista składa się z różnych gatunków – lista słów kluczowych związanych z gatunkiem, który jest reprezentowany przez playlistę. Obecność tej usługi informuje Google, że chcesz, aby ta playlista była playlistą gatunków.
numTracks Liczba całkowita Wymagany, jeśli playlista zawiera wyselekcjonowaną składankę – liczba utworów na playliście. Obecność tej usługi informuje Google, że ta playlista jest wyselekcjonowana ręcznie. Brak tej właściwości będzie wskazywać, że playlista jest niekończącą się playlistą generowaną automatycznie.
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ń.
image ImageObject Obraz playlisty, który reprezentuje playlistę lub składankę muzyczną. Zobacz Właściwości znaczników obrazów.
creator Organizacja lub Osoba Zalecane, jeśli twórca cieszy się dużym zainteresowaniem. Użyj tej właściwości, by wskazać playlisty utworzone przez Twoją usługę (wpisane jako Organizacja z właściwością name wskazującą na Twoją usługę) lub wskazać zainteresowanego użytkownika usługi (wpisane jako Person z właściwością name, która wskazuje interesującego użytkownika).
keywords Tekst Lista słów kluczowych („rockowy”, „pop”), nastrojów („wesoły”, „nastrojowy”), aktywności („ćwiczenia”, „relaks”) lub innych haseł związanych z playlistą.
description Tekst Krótki opis playlisty. 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)

Przykład

Przykład zawierający ręcznie wyselekcjonowaną playlistę utworów pop z drugiej dekady XXI wieku:

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicPlaylist",
  "@id":"http://www.example.com/playlist/top-pop-songs/",
  "url":"http://www.example.com/playlist/top-pop-songs/",
  "name":"Top Pop Songs of the 2010s",
  "image":[
  {
    "@type": "ImageObject",
    "contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo1.jpg",
    "dateModified" : "2018-01-05T22:11:33+00:00",
    "regionsAllowed" : ["US","UK","MX"]
  },
  {
    "@type": "ImageObject",
    "contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo2.jpg",
    "dateModified" : "2018-01-05T22:11:33+00:00",
    "regionsAllowed" : ["UA", "IR"]
  }],
  "genre": [
     "pop",
     "2010s"
  ],
  "numTracks":"46",
  "potentialAction":{
    "@type":"ListenAction",
    "target":[
      {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/playlist/top-pop-songs?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"
        ]
      },
      {
        "@type": "EntryPoint",
        "urlTemplate": "android-app://com.app.example/playlist/top-pop-songs?autoplay=true",
        "actionPlatform": "http://schema.org/AndroidPlatform"
      }
    ],
    "expectsAcceptanceOf":{
      "@type":"Offer",
      "category":"free",
      "eligibleRegion": {
        "@type":"Country",
        "name":"US"
      }
    }
  },
  "creator": {
    "@type": "Organization",
    "name": "example.com"
  },
  "keywords": [
    "pop",
    "Party music"
  ],
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description":"Top pop songs from the last decade."
}

Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami: