Właściwości znaczników treści na playlistach muzycznych

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

Specyfikacja

Właściwość Oczekiwany typ Opis
@context tekstowy. Wymagany – zawsze ustawiony na ["http://schema.googleapis.com", {"@language": "xx"}].
  • Gdzie „"xx"” wskazuje język ciągów znaków w pliku danych. Każdy kontekst encji głównej powinien mieć w polu @language ustawiony odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest hiszpański, uznamy, że nazwy są w języku hiszpańskim, nawet jeśli język napisów jest w języku angielskim.
@type tekstowy. Wymagany – zawsze ustawiany na MusicPlaylist w przypadku składanek.
@id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Niepowtarzalny globalnie w Twoim katalogu
  • Statyczny; identyfikator powinien być stały i nie może zmieniać się w czasie (nawet jeśli właściwość url programu ulegnie zmianie). Będzie 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.
Element url spełnia wszystkie wymagania jako identyfikator, więc zalecamy użycie elementu url jako właściwości @id. Więcej informacji znajdziesz w sekcji Identyfikator.
url Adres URL Wymagane – kanoniczny URL treści, którego Google używa do dopasowania treści z pliku danych do treści w bazach danych Google.
url musi spełniać te wymagania:
  • url musi być unikalny globalnie
  • url musi zawierać działający kanoniczny URL, który może być indeksowany przez Google.
  • url musi wskazywać stronę z opisem treści, która nie jest zablokowana przez system paywall.
    • Zamiast tego
odtwarzaj precyzyjny link, patrz właściwość docelowydocelowyurlTemplate.
name tekstowy. Wymagany – nazwa playlisty, na przykład "składanka jazzowa.
genre tekstowy. Wymagany, jeśli playlista jest z danego gatunku – lista słów kluczowych związanych z danym gatunkiem, do którego należy playlista. Obecność tej właściwości wskazuje Google, że ta playlista należy do gatunku.
numTracks Liczba całkowita Wymagany, jeśli playlista to wyselekcjonowana składanka – liczba utworów na playliście. Obecność tej właściwości wskazuje Google, że ta playlista jest wyselekcjonowana ręcznie. Brak tej właściwości oznacza, że playlista jest niekończąca się automatycznie.
potentialAction ListenAction (słuchanie) Wymagane – obiekt znacznika działania zawierający szczegóły działania. Więcej informacji znajdziesz we właściwościach znaczników działania.
image ImageObject Obraz playlisty reprezentujący playlistę lub składankę muzyczną. Zobacz Właściwości znaczników obrazu.
creator Organizacja lub Osoba Zalecane, jeśli jest on ważny. Użyj tej właściwości, aby wskazać playlisty utworzone w ramach Twojej usługi (określone jako Organizacja z użyciem właściwości name) lub użytkowników o dużym zainteresowaniu usługi (w polu Osoba wskazuje ona zainteresowanego użytkownika).
keywords tekstowy. Lista słów kluczowych ("rock", "pop" nastroje ("happy", "moody"), aktywności ("exercise", "relaxing") lub inne hasła związane z playlistą.
description tekstowy. Krótki opis playlisty. Limit 300 znaków.
isFamilyFriendly Wartość logiczna Wskazuje, czy te treści są przeznaczone dla całej rodziny (czyli 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 Specyfikacja wyniku popularności Zdecydowanie zalecamy powód? Wynik wykorzystywany przez Google wraz z innymi sygnałami do określenia, które multimedia odtwarzać użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w Twoim katalogu. Dlatego skala wyniku musi być spójna dla wszystkich kanałów w obrębie wszystkich elementów w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
popularityScore.@type tekstowy. Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value Number Nieujemna wartość liczbowa, która wskazuje popularność elementu. Wyższy wynik oznacza większą popularność.
popularityScore.eligibleRegion Kraj Regiony, w których taki wynik jest używany. Jeśli ocena popularności ma zastosowanie globalnie, ustaw wartość EARTH. Domyślnie ta właściwość ma wartość EARTH.
Note: Popularność w konkretnym języku ma pierwszeństwo przed międzynarodową (EARTH)

Przykład

Przykład zawierający wyselekcjonowaną playlistę utworów pop z drugiej dekady XX 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."
}

Przejrzyj te strony dotyczące tematów powiązanych z tymi właściwościami: