Eigenschaften von Inhalts-Markup von Musikplaylists

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

Spezifikationstabelle

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich – Immer auf ["http://schema.googleapis.com", {"@language": "xx"}] gesetzt.
  • Wobei „xx“ ist die Sprache der Strings im Feed. Für jeden Kontext der Stammentität sollte @language auf den entsprechenden Sprachcode im Format BCP 47 festgelegt sein. Wenn als Sprache beispielsweise Spanisch eingestellt ist, wird angenommen, dass die Namen auf Spanisch sind, auch wenn die Sprache der Untertitel/Synchronisation auf Englisch ist.
@type Text Erforderlich: Für Mixe immer auf MusicPlaylist gesetzt.
@id URL Erforderlich: Die ID des Inhalts im URI-Format. Beispiel: https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global in deinem Katalog einzigartig
  • Statisch; Die ID sollte immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Sendung ändert. Er wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form von URI (Unified Resource Identifier)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen an eine Kennung erfüllt, empfehlen wir, die url einer Entität als @id zu verwenden. 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 Seite mit einer Inhaltsbeschreibung verweisen, die nicht durch eine Paywall blockiert wird.
Den Deeplink der Wiedergabe findest du unter der Eigenschaft urlTemplate des target-Objekts.
name Text Erforderlich: Der Name der Playlist, zum Beispiel „Funky Jazz Mix“. <ph type="x-smartling-placeholder">
genre Text Erforderlich, wenn die Playlist ein Genre-Mix ist: eine Liste mit Keywords, die für das Genre spezifisch sind, das die Playlist repräsentiert. Das Vorhandensein dieser Property signalisiert Google, dass diese Playlist eine Genre-Playlist sein soll.
numTracks Ganzzahl Erforderlich, wenn es sich um einen Mix mit ausgewählten Inhalten handelt: Anzahl der Titel in der Playlist. Das Vorhandensein dieser Unterkunft signalisiert Google, dass diese Playlist von Hand zusammengestellt wurde. Falls diese Eigenschaft nicht vorhanden ist, bedeutet dies, dass es sich bei der Playlist um eine automatisch erstellte Endlos-Playlist handelt.
potentialAction ListenAction Erforderlich: Ein Aktions-Markup-Objekt, das die Details der Aktion enthält. Weitere Informationen finden Sie unter Eigenschaften des Aktions-Markups.
image ImageObject Ein Playlist-Bild, das die Playlist oder den Musikmix repräsentiert. Siehe Eigenschaften des Bild-Markups.
creator Organization oder Person Empfohlen, wenn der Creator großes Interesse hat. Verwende diese Eigenschaft, um die von deinem Dienst erstellten Playlists (Typ Organisation mit der Eigenschaft name, die deinen Dienst angibt) oder einen Nutzer mit hohem Interesse an deinem Dienst (Typ Person, wobei die Eigenschaft name den Interessenten angibt) anzugeben.
keywords Text Eine Liste von Keywords („Rock“, „Pop“), Stimmungen („glücklich“, „stimmig“), Aktivitäten („Sport“, „Entspannen“) oder andere mit der Playlist in Zusammenhang stehende Begriffe
description Text Eine kurze Beschreibung der Playlist. Maximal 300 Zeichen.
isFamilyFriendly Boolesch Gibt an, ob der Inhalt familienfreundlich ist, also für alle Familienmitglieder, einschließlich Kinder, geeignet ist. Google-Produkte verwenden möglicherweise isFamilyFriendly, um zu bestimmen, welcher Song abgespielt werden soll.
popularityScore PopularityScoreSpecification Dringend empfohlen Warum? Eine Bewertung, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer abgespielt werden. Dieser Wert gibt an, wie beliebt der Inhalt im Vergleich zu anderen Inhalten in deinem Katalog ist. Daher muss die Skala des Werts in Ihren Feeds und bei allen Entitäten in Ihrem Katalog einheitlich sein. Die Beliebtheitsrate einer Entität ist standardmäßig auf 0 festgelegt.
popularityScore.@type Text Immer auf PopularityScoreSpecification festlegen.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Je höher die Bewertung, desto beliebter sind sie.
popularityScore.eligibleRegion Land Region(en), in der dieser Beliebtheitswert gilt. Wenn die Beliebtheitsrate weltweit anwendbar ist, legen Sie diesen Wert auf EARTH fest. Diese Eigenschaft ist standardmäßig auf EARTH festgelegt.
Note: Die sprachspezifische Beliebtheit hat Vorrang vor der globalen Beliebtheit (EARTH).

Beispiel

Beispiel für eine von Hand zusammengestellte Playlist mit Popsongs der 2010er-Jahre:

{
  "@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 Informationen zu Themen im Zusammenhang mit diesen Properties: