Markup-Eigenschaften von Musikplaylists

Dieser Abschnitt enthält Details zu den Inhalts-Markup-Eigenschaften für den MusicPlaylist-Entitätstyp.

Spezifikationstabelle

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Immer auf ["http://schema.googleapis.com", {"@language": "xx"}] festgelegt.
  • Dabei steht xx für die Sprache der Strings im Feed. Für jeden Stammentitätskontext sollte „@language“ auf den entsprechenden Sprachcode im Format BCP 47 festgelegt sein. Wenn die Sprache beispielsweise auf Spanisch eingestellt ist, wird angenommen, dass die Namen auf Spanisch sind, auch wenn die Sprache der Untertitel auf Englisch ist.
@type Text Erforderlich: Für Mixe immer auf MusicPlaylist festlegen.
@id URL Erforderlich: Die Kennzeichnung des Inhalts im URI-Format, z. B. https://beispiel.de/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog
  • Statisch; Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern (auch wenn sich die URL-Property der Sendung ändert). Er wird als opaker String behandelt und muss kein gültiger Link sein.
  • In Form von Unified Resource Identifier (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da url eine Entität alle Anforderungen als Kennung erfüllt, empfehlen wir die Verwendung der url einer Entität als @id. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL des Inhalts, die Google verwendet, um die Inhalte in Ihrem Feed mit den Inhalten in den Datenbanken von Google abzugleichen.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die Google crawlen kann.
  • url muss auf eine Content-Beschreibungsseite verweisen, die nicht von einer Paywall blockiert wird.
Informationen zur Deeplink-Wiedergabe finden Sie in der urlTemplate-Property des Zielobjekts.
name Text Erforderlich: Der Name der Playlist, zum Beispiel "Funky Jazz Mix".
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Weitere Informationen finden Sie im Beispiel Mehrere Regionen und Sprachen.
genre Text Erforderlich, wenn die Playlist ein Genre-Mix ist – Eine Liste von Keywords, die spezifisch für das Genre sind, das von der Playlist repräsentiert wird. Das Vorhandensein dieser Property signalisiert Google, dass es sich bei dieser Playlist um eine Genre-Playlist handelt.
numTracks Ganzzahl Erforderlich, wenn die Playlist eine ausgewählte Kombination ist: die Anzahl der Titel in der Playlist. Das Vorhandensein dieser Eigenschaft signalisiert Google, dass diese Playlist von Hand zusammengestellt wird. Fehlt diese Property, ist die Playlist eine endlose, automatisch generierte Playlist.
potentialAction ListenAction Erforderlich: ein Aktions-Markup-Objekt, das die Details der Aktion enthält Weitere Informationen finden Sie unter Eigenschaften von Aktions-Markup.
image ImageObject Ein Playlistbild, das die Playlist oder den Musikmix darstellt. Siehe Eigenschaften von Bild-Markup
creator Organisation oder Person Empfohlen, wenn der Creator von großem Interesse ist. Verwenden Sie diese Property, um die von Ihrem Dienst erstellten Playlists anzugeben (eingegeben als Organisation mit seiner name-Property, die Ihren Dienst angibt) oder für einen Nutzer, der ein hohes Interesse an Ihrem Dienst hat (eingegeben als Person mit seiner name-Property, die den gewünschten Nutzer angibt).
keywords Text Eine Liste von Keywords ("rock", "pop"), Stimmungen ("Happy", "moody"), Aktivitäten ("sport", "relaxing") oder andere ähnliche Begriffe zur Playlist.
description Text Eine kurze Beschreibung der Playlist. Max. 300 Zeichen.
  • Verwende ein Array, um die Beschreibung in mehreren Sprachen auszuzeichnen. Weitere Informationen finden Sie im Beispiel Mehrere Regionen und Sprachen.
isFamilyFriendly Boolesch Gibt an, ob dieser Inhalt familienfreundlich ist, also für alle Familienmitglieder, einschließlich Kindern, geeignet ist. Google-Produkte können isFamilyFriendly zur Bestimmung eines Titels verwenden.
popularityScore Beliebtheitsfaktor Dringende Empfehlung Warum? Eine Punktzahl, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer abgespielt werden. Dieser Index spiegelt die Beliebtheit des Contents im Verhältnis zu anderem Content in Ihrem Katalog wider. Daher muss die Punktzahl des Index in allen Feeds Ihres Feeds einheitlich sein. Standardmäßig ist der Beliebtheitswert einer Entität auf 0 festgelegt.
popularityScore.@type Text Immer auf PopularityScoreSpecification festgelegt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Eine höhere Punktzahl bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Region(en), in denen dieser Beliebtheitsfaktor gilt. Wenn der Beliebtheitsfaktor weltweit anwendbar ist, legen Sie EARTH fest. Die Standardeinstellung für diese Property ist EARTH.
Note: Die gebietsspezifische Beliebtheit hat Vorrang vor der globalen (EARTH) Beliebtheit

Beispiel

Beispiel für eine manuell zusammengestellte Playlist der Popsongs der 2010er:

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

Auf den folgenden Seiten finden Sie Themen zu diesen Properties: