Właściwości playlist muzycznych

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

Tabela specyfikacji

Właściwość Oczekiwany typ Opis
@context Text Wymagany – zawsze ma wartość ["http://schema.googleapis.com", {"@language": "xx"}].
  • Gdzie „xx” reprezentuje język ciągów w pliku danych. Każdy kontekst elementu wyższego rzędu powinien mieć atrybutu @language ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład ustawisz język hiszpański, nazwy będą w tym języku, nawet jeśli język napisów lub dubbingu to angielski.
@type Text Wymagany – w przypadku miksów zawsze ustawiaj wartość na MusicPlaylist.
@id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • niepowtarzalny na całym świecie w katalogu;
  • Statyczny; identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość adresu URL programu). Jest on traktowany jako ciąg nieprzejrzysty, więc nie musi być działającym linkiem.
  • w formie ujednoliconego identyfikatora zasobu (URI);
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Ponieważ 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:
  • url musi być globalnie niepowtarzalny
  • url musi zawierać działający kanoniczny adres URL, który Google może zindeksować.
  • url musi wskazywać stronę z opisem treści, która nie jest blokowana przez paywall.
Aby uzyskać dostęp do precyzyjnego linku odtwarzania, użyj właściwości urlTemplate obiektu docelowego.
name Text Wymagany: nazwa playlisty, np. „Funky Jazz Mix”.
genre Text Wymagane, jeśli playlista zawiera różne gatunki – lista słów kluczowych związanych z gatunkiem, który reprezentuje playlista. Obecność tej właściwości sygnalizuje Google, że ta playlista ma być playlistą zawierającą utwory z jednego gatunku.
numTracks Liczba całkowita Wymagane, jeśli playlista jest selekcją utworów – liczba utworów na playliście. Jego obecność wskazuje Google, że ta playlista jest ręcznie selekcjonowana. Brak tej właściwości oznacza, że playlista jest niekończącą się automatycznie wygenerowaną playlistą.
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.
image ImageObject Obraz playlisty, który reprezentuje playlistę lub miks muzyczny. Zobacz Właściwości znaczników obrazu.
creator Organization lub Person Zaleca się, jeśli twórca jest bardzo interesujący. Użyj tej właściwości, aby wskazać playlisty utworzone przez Twoją usługę (oznaczone jako Organizacja z właściwością name wskazującą Twoją usługę) lub użytkownika Twojej usługi, który wykazuje duże zainteresowanie (oznaczony jako Osoba z właściwością name wskazującą zainteresowanego użytkownika).
keywords Text lista słów kluczowych („rock”, „pop”), nastrojów („szczęśliwy”, „nastrojowy”), aktywności („ćwiczenie”, „relaks”) lub innych terminów związanych z playlistą;
description Text Krótki opis playlisty. 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 odtwarzać dla użytkowników. 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ść danego 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).

Przykład

Przykład zawierający playlistę z ręcznie wyselekcjonowanymi utworami popowymi z 2010 roku:

{
  "@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."
}

Aby dowiedzieć się więcej o tych usługach, zapoznaj się z tymi stronami: