In diesem Abschnitt finden Sie die Details der Inhalts-Markup-Properties für die Entitätstypen MusicGroup, MusicAlbum und MusicRecording.
Spezifikationstabelle
MusicGroup
| Attribut | Erwarteter Typ | Beschreibung |
|---|---|---|
@context |
Text | Erforderlich: Muss immer auf ["http://schema.googleapis.com", {"@language": "xx"}] gesetzt sein.
|
@type |
Text | Erforderlich: Für Künstler und Gruppen immer auf MusicGroup festgelegt. |
@id |
URL | Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.@id muss die folgenden Anforderungen erfüllen:
url einer Einheit alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Einheit als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung. |
url |
URL | Erforderlich: Die kanonische URL der Inhalte, die Google verwendet, um die Inhalte in Ihrem Feed mit den Inhalten in den Google-Datenbanken abzugleichen.url muss die folgenden Anforderungen erfüllen:
urlTemplate des Objekts target. |
name |
Text | Erforderlich: Der Name des Künstlers oder der Gruppe.
|
potentialAction |
ListenAction | Erforderlich: Ein Action-Markup-Objekt, das die Details der Aktion enthält. Weitere Informationen finden Sie unter Eigenschaften für Aktions-Markup.
|
subjectOf |
MusicPlaylist | Erforderlich für entitätsbasierte Aktionen: Details für die entitätsbasierte Aktion. |
subjectOf.@type |
Text | Erforderlich für auf Entitäten basierende Aktionen: Diese Property ist immer auf MusicPlaylist festgelegt. |
subjectOf.@id |
URL | Erforderlich für entitätsbasierte Aktionen: Die Kennung für die entitätsbasierte Aktion. Weitere Informationen finden Sie oben unter @id. Er muss sich vom @id für den Künstler/die Gruppe unterscheiden. |
subjectOf.url |
URL | Erforderlich für entitätsbasierte Aktionen: Die kanonische URL für die entitätsbasierte Aktion. Weitere Informationen finden Sie oben unter url. Sie können diesen Schritt überspringen, wenn er mit dem url für den Künstler/die Gruppe übereinstimmt. |
subjectOf.potentialAction |
ListenAction | Erforderlich für auf Entitäten basierende Aktionen: Ein Action-Markup-Objekt, das die Details der Aktion enthält. Weitere Informationen finden Sie unter Eigenschaften für Aktions-Markup.
|
image |
ImageObject | Bild, das die MusicGroup repräsentiert. Weitere Informationen finden Sie unter Eigenschaften für Bild-Markup. |
sameAs |
URL | Eine URL zu einer Referenzwebseite, die den Künstler identifizieren kann, z. B. die Wikipedia-Seite des Künstlers. Muss sich von der Property url unterscheiden. |
description |
Text | Eine kurze Biografie des Künstlers. Max. 300 Zeichen.
|
isFamilyFriendly |
Boolesch | Gibt an, ob dieser Inhalt familienfreundlich ist, d. h. für alle Familienmitglieder, einschließlich Kinder, geeignet ist. Google-Produkte können isFamilyFriendly verwenden, um zu bestimmen, welcher Song abgespielt werden soll. |
popularityScore |
PopularityScoreSpecification | Sehr empfehlenswert Warum? Eine Punktzahl, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Verhältnis zu anderen Inhalten in Ihrem Katalog an. Daher muss die Skala des Werts in allen Feeds und für alle Entitäten in Ihrem Katalog einheitlich sein. Standardmäßig ist die Beliebtheitsbewertung einer Entität auf 0 festgelegt. |
popularityScore.@type |
Text | Immer auf PopularityScoreSpecification gesetzt. |
popularityScore.value |
Number | Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit. |
popularityScore.eligibleRegion |
Land | Region(en), in denen dieser Beliebtheitswert gilt. Wenn der Beliebtheitswert global gilt, legen Sie ihn auf EARTH fest. Standardmäßig ist dieses Attribut auf EARTH gesetzt. Note: Länderspezifische Beliebtheit hat Vorrang vor globaler (EARTH) Beliebtheit |
MusicAlbum
| Attribut | Erwarteter Typ | Beschreibung |
|---|---|---|
@context |
Text | Erforderlich: Muss immer auf ["http://schema.googleapis.com", {"@language": "xx"}] gesetzt sein.
|
@type |
Text | Erforderlich: Für Alben immer auf MusicAlbum gesetzt. |
@id |
URL | Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.@id muss die folgenden Anforderungen erfüllen:
url einer Einheit alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Einheit als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung. |
url |
URL | Erforderlich: Die kanonische URL der Inhalte, die Google verwendet, um die Inhalte in Ihrem Feed mit den Inhalten in den Google-Datenbanken abzugleichen.url muss die folgenden Anforderungen erfüllen:
urlTemplate des Objekts target. |
name |
Text | Erforderlich: Der Name des Albums.
|
byArtist |
MusicGroup | Erforderlich: Der Künstler oder die Gruppe, die dieses Album aufgenommen hat. Sie müssen mindestens die eindeutige @id angeben, die Sie für den Künstler verwenden, sowie den Namen des Künstlers. Wenn dem Album mehrere Künstler zugeordnet sind, können Sie ein Array von Werten in „byArtist“ angeben. |
byArtist.@type |
Text | Erforderlich: Für diese Property muss immer MusicGroup festgelegt werden. |
byArtist.@id |
URL | Erforderlich: Die Kennung für den Künstler des Albums. Weitere Informationen finden Sie oben unter @id. Er muss mit dem @id übereinstimmen, das Sie für den Künstler/die Gruppe an anderer Stelle in Ihrem Feed verwenden. |
byArtist.name |
Text | Erforderlich: Der Name des Künstlers oder der Gruppe. |
potentialAction |
ListenAction | Erforderlich: Ein Action-Markup-Objekt, das die Details der Aktion enthält. Weitere Informationen finden Sie unter Eigenschaften für Aktions-Markup.
|
subjectOf |
MusicPlaylist | Erforderlich für entitätsbasierte Aktionen: Details für die entitätsbasierte Aktion. |
subjectOf.@type |
Text | Erforderlich für auf Entitäten basierende Aktionen: Diese Property ist immer auf MusicPlaylist festgelegt. |
subjectOf.@id |
URL | Erforderlich für entitätsbasierte Aktionen: Die Kennung für die entitätsbasierte Aktion. Weitere Informationen finden Sie oben unter @id. Sie muss sich von der @id für das Album unterscheiden. |
subjectOf.url |
URL | Erforderlich für entitätsbasierte Aktionen: Die kanonische URL für die entitätsbasierte Aktion. Weitere Informationen finden Sie oben unter url. Sie können diesen Schritt überspringen, wenn er mit dem url für das Album identisch ist. |
subjectOf.potentialAction |
ListenAction | Erforderlich für auf Entitäten basierende Aktionen: Ein Action-Markup-Objekt, das die Details der Aktion enthält. Weitere Informationen finden Sie unter Eigenschaften für Aktions-Markup.
|
image |
ImageObject | Bild, das das MusicAlbum repräsentiert. Weitere Informationen finden Sie unter Eigenschaften für Bild-Markup. |
sameAs |
URL | Eine URL zu einer Referenzwebseite, auf der das Album identifiziert werden kann, z. B. die Wikipedia-Seite des Albums. Muss sich von der Property url unterscheiden. |
numTracks |
Ganzzahl | Die Anzahl der Songs oder Titel auf diesem Album. |
timeRequired |
Text | Die Länge des Albums im ISO 8601-Format. |
description |
Text | Eine kurze Beschreibung des Albums. Max. 300 Zeichen.
|
isFamilyFriendly |
Boolesch | Gibt an, ob dieser Inhalt familienfreundlich ist, d. h. für alle Familienmitglieder, einschließlich Kinder, geeignet ist. Google-Produkte können isFamilyFriendly verwenden, um zu bestimmen, welcher Song abgespielt werden soll. |
popularityScore |
PopularityScoreSpecification | Eine Punktzahl, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Verhältnis zu anderen Inhalten in Ihrem Katalog an. Daher muss die Skala des Werts in allen Feeds und für alle Entitäten in Ihrem Katalog einheitlich sein. Standardmäßig ist die Beliebtheitsbewertung einer Entität auf 0 festgelegt. |
popularityScore.@type |
Text | Immer auf PopularityScoreSpecification gesetzt. |
popularityScore.value |
Number | Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit. |
popularityScore.eligibleRegion |
Land | Region(en), in denen dieser Beliebtheitswert gilt. Wenn der Beliebtheitswert global gilt, legen Sie ihn auf EARTH fest. Standardmäßig ist dieses Attribut auf EARTH gesetzt. |
MusicRecording
| Attribut | Erwarteter Typ | Beschreibung |
|---|---|---|
@context |
Text | Erforderlich: Muss immer auf ["http://schema.googleapis.com", {"@language": "xx"}] gesetzt sein.
|
@type |
Text | Erforderlich: Für Songs/Titel immer auf MusicRecording gesetzt. |
@id |
URL | Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.@id muss die folgenden Anforderungen erfüllen:
url einer Einheit alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Einheit als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung. |
url |
URL | Erforderlich: Die kanonische URL der Inhalte, die Google verwendet, um die Inhalte in Ihrem Feed mit den Inhalten in den Google-Datenbanken abzugleichen.url muss die folgenden Anforderungen erfüllen:
urlTemplate des Objekts target. |
name |
Text | Erforderlich: Der Name des Songs.
|
byArtist |
MusicGroup | Erforderlich: Der Künstler oder die Gruppe, die diesen Song aufgenommen hat. Sie müssen mindestens die eindeutige @id angeben, die Sie für den Künstler verwenden, sowie den Namen des Künstlers. Wenn dem Song mehrere Künstler zugeordnet sind, können Sie ein Array von Werten in „byArtist“ angeben. |
byArtist.@type |
Text | Erforderlich: Für diese Property muss immer MusicGroup festgelegt werden. |
byArtist.@id |
URL | Erforderlich: Die Kennung für den Künstler des Songs. Weitere Informationen finden Sie oben unter @id. Er muss mit dem @id übereinstimmen, das Sie für den Künstler/die Gruppe an anderer Stelle in Ihrem Feed verwenden. |
byArtist.name |
Text | Erforderlich: Der Name des Künstlers oder der Gruppe. |
potentialAction |
ListenAction | Erforderlich: Ein Action-Markup-Objekt, das die Details der Aktion enthält. Weitere Informationen finden Sie unter Eigenschaften für Aktions-Markup.
|
subjectOf |
MusicPlaylist | Erforderlich für entitätsbasierte Aktionen: Details für die entitätsbasierte Aktion |
subjectOf.@type |
Text | Erforderlich für auf Entitäten basierende Aktionen: Diese Property ist immer auf MusicPlaylist festgelegt. |
subjectOf.@id |
URL | Erforderlich für entitätsbasierte Aktionen: Die Kennung für die entitätsbasierte Aktion. Weitere Informationen finden Sie oben unter @id. Sie muss sich von der @id für den Titel unterscheiden. |
subjectOf.url |
URL | Erforderlich für entitätsbasierte Aktionen: Die kanonische URL für die entitätsbasierte Aktion. Weitere Informationen finden Sie oben unter url. Sie können diesen Schritt überspringen, wenn er mit dem url für den Song identisch ist. |
subjectOf.potentialAction |
ListenAction | Erforderlich für auf Entitäten basierende Aktionen: Ein Action-Markup-Objekt, das die Details der Aktion enthält. Weitere Informationen finden Sie unter Eigenschaften für Aktions-Markup.
|
image |
ImageObject | Bild, das die Musikaufnahme darstellt. Weitere Informationen finden Sie unter Eigenschaften für Bild-Markup. |
sameAs |
URL | Eine URL zu einer Referenzwebseite, auf der das Album identifiziert werden kann, z. B. die Wikipedia-Seite des Albums. Muss sich von der Property url unterscheiden. |
inAlbum |
MusicAlbum | Das Album, auf dem der Titel erscheint, falls vorhanden. |
inAlbum.@type |
Text | Für diese Property immer auf MusicAlbum festgelegt. |
inAlbum.@id |
URL | Die Kennung für das Album. Weitere Informationen finden Sie oben unter @id. Er muss mit dem @id übereinstimmen, das Sie für das Album an anderer Stelle in Ihrem Feed verwenden. |
inAlbum.name |
Text | Der Name des Albums. |
duration |
Text | Die Länge des Songs. Die Angabe erfolgt im ISO 8601-Format. |
description |
Text | Eine kurze Beschreibung des Songs. Max. 300 Zeichen.
|
isFamilyFriendly |
Boolesch | Gibt an, ob diese Inhalte familienfreundlich sind, d. h. für alle Mitglieder einer Familie, einschließlich Kinder, geeignet sind. Google-Produkte können isFamilyFriendly verwenden, um zu bestimmen, welcher Song abgespielt werden soll. |
popularityScore |
PopularityScoreSpecification | Eine Punktzahl, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Verhältnis zu anderen Inhalten in Ihrem Katalog an. Daher muss die Skala des Werts in allen Feeds und für alle Entitäten in Ihrem Katalog einheitlich sein. Standardmäßig ist die Beliebtheitsbewertung einer Entität auf 0 festgelegt. |
popularityScore.@type |
Text | Immer auf PopularityScoreSpecification gesetzt. |
popularityScore.value |
Number | Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit. |
popularityScore.eligibleRegion |
Land | Region(en), in denen dieser Beliebtheitswert gilt. Wenn der Beliebtheitswert global gilt, legen Sie ihn auf EARTH fest. Standardmäßig ist dieses Attribut auf EARTH gesetzt. |
Beispiele
MusicGroup
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicGroup",
"@id":"http://www.example.com/artist/my_favorite_artist/",
"url":"http://www.example.com/artist/my_favorite_artist/",
"sameAs": "http://www.my_favorite_artist.com",
"name":"My Favorite Artist",
"description":"This is my favorite artist.",
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/artist/my_favortie_artist/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 92,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/artist/my_favorite_artist?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/artist_mix/my_favorite_artist/",
"url":"http://www.example.com/artist_mix/my_favorite_artist/",
"name":"My Favorite Artist Mix",
"description":"A playlist of songs similar to My Favorite Artist",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
MusicAlbum
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicAlbum",
"@id":"http://www.example.com/album/my_favorite_album",
"url":"http://www.example.com/album/my_favorite_album",
"name":"My Favorite Album",
"sameAs":"https://en.wikipedia.org/wiki/my_favorite_album_(my_favorite_artist_album)",
"description":"This is my favorite album.",
"datePublished":"2010-08-24",
"numTracks":"12",
"timeRequired":"P44M02S",
"byArtist":{
"@type":"MusicGroup",
"@id": "http://www.example.com/artist/my_favorite_artist/",
"name":"My Favorite Artist"
},
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 87,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/album/my_favorite_album?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/album_mix/my_favorite_album",
"url":"http://www.example.com/album_mix/my_favorite_album",
"name":"My Favorite Album Mix",
"description":"A playlist of songs similar to My Favorite Album",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/album_mix/my_favorite_album?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
MusicRecording
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicRecording",
"@id":"http://www.example.com/track/my_favorite_song",
"url":"http://www.example.com/track/my_favorite_song",
"name":"My Favorite Song",
"sameAs":"https://en.wikipedia.org/wiki/my_favorite_song_(song)",
"description":"This is my favorite song.",
"datePublished":"2010-08-24",
"duration":"PT3M54S",
"byArtist":{
"@type":"MusicGroup",
"@id": "http://www.example.com/artist/my_favorite_song/",
"name":"My Favorite Artist"
},
"inAlbum":{
"@type":"MusicAlbum",
"@id":"http://www.example.com/album/my_favorite_album",
"name":"My Favorite Album"
},
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 97,
"eligibleRegion": "EARTH"
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/track/my_favorite_song?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"
]
},
"expectsAcceptanceOf": {
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/track_mix/my_favorite_song",
"url":"http://www.example.com/track_mix/my_favorite_song",
"name":"My Favorite Song Mix",
"description":"A playlist of songs similar to My Favorite Song",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/track_mix/my_favorite_song?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
Weitere Informationen
Weitere Informationen zu den Themen, die mit diesen Attributen zusammenhängen, finden Sie auf den folgenden Seiten: