Bu bölümde, MusicGroup, MusicAlbum ve MusicRecording öğe türleri için içerik işaretleme özelliklerinin ayrıntıları verilmektedir.
Spesifikasyon tablosu
MusicGroup
| Mülk | Beklenen Tür | Açıklama |
|---|---|---|
@context |
Metin | Zorunlu: Her zaman ["http://schema.googleapis.com", {"@language": "xx"}] değerine ayarlanır.
|
@type |
Metin | Zorunlu: Sanatçılar ve gruplar için her zaman MusicGroup olarak ayarlayın. |
@id |
URL | Zorunlu: İçeriğin URI biçimindeki tanımlayıcısı (ör. https://example.com/1234abc).@id aşağıdaki koşulları karşılamalıdır:
url özelliği, tanımlayıcı olarak tüm koşulları karşıladığı için @id olarak öğenin url özelliğini kullanmanızı öneririz. Daha ayrıntılı bilgi için Tanımlayıcı bölümüne bakın. |
url |
URL | Zorunlu: Google'ın, feed'inizdeki içeriği Google'ın veritabanlarındaki içerikle eşleştirmek için kullandığı, içeriğin standart URL'si.url Aşağıdaki şartları karşılamalıdır:
urlTemplate özelliğine bakın. |
name |
Metin | Zorunlu: Sanatçının veya grubun adı.
|
potentialAction |
ListenAction | Zorunlu: İşlemin ayrıntılarını sağlayan bir işlem işaretleme nesnesi. Ayrıntılar için İşlem işaretleme özellikleri bölümüne bakın.
|
subjectOf |
MusicPlaylist | Varlık temelli işlemler için gereklidir: Varlık temelli işlem ile ilgili ayrıntılar. |
subjectOf.@type |
Metin | Varlık temelli işlemler için zorunludur: Bu özellik için her zaman MusicPlaylist olarak ayarlayın. |
subjectOf.@id |
URL | Varlık temelli işlemler için zorunludur: Varlık temelli işlemin tanımlayıcısı. @id ile ilgili şartları yukarıda bulabilirsiniz. Sanatçı/grup için @id değerinden farklı olmalıdır. |
subjectOf.url |
URL | Varlık temelli işlemler için zorunlu: Varlık temelli işlemin standart URL'si. url ile ilgili şartları yukarıda bulabilirsiniz. Sanatçı/grup için url ile aynıysa bunu atlayabilirsiniz. |
subjectOf.potentialAction |
ListenAction | Öğe tabanlı işlemler için gereklidir: İşlemin ayrıntılarını sağlayan bir işlem işaretleme nesnesi. Ayrıntılar için İşlem işaretleme özellikleri bölümüne bakın.
|
image |
ImageObject | MusicGroup'u temsil eden resim. Resim işaretleme özelliklerine bakın. |
sameAs |
URL | Sanatçıyı tanımlayabilecek bir referans web sayfasının URL'si (ör. sanatçının Wikipedia sayfası). Bu, url özelliğinden farklı olmalıdır. |
description |
Metin | Sanatçının kısa bir biyografisi. 300 karakter sınırı vardır.
|
isFamilyFriendly |
Boole | Bu içeriğin aileye uygun olup olmadığını (yani içeriğin çocuklar dahil bir ailenin tüm üyeleri için uygun olup olmadığını) belirtir. Google ürünleri, çalınacak şarkıyı belirlerken isFamilyFriendly kullanabilir. |
popularityScore |
PopularityScoreSpecification | Önemle Tavsiye Edilir Neden? Google'ın, kullanıcılar için hangi medyanın oynatılacağını belirlemek üzere diğer sinyallerle birlikte kullandığı bir puan. Bu puan, içeriğin kataloğunuzdaki diğer içeriklere kıyasla ne kadar popüler olduğunu gösterir. Bu nedenle, puanın ölçeği feed'lerinizde ve kataloğunuzdaki tüm öğelerde tutarlı olmalıdır. Varsayılan olarak, bir öğenin popülerlik puanı 0'a ayarlanır. |
popularityScore.@type |
Metin | Her zaman PopularityScoreSpecification olarak ayarlanır. |
popularityScore.value |
Number | Varlığın popülerliğini gösteren negatif olmayan bir sayısal değerdir. Puan ne kadar yüksekse popülerlik de o kadar yüksektir. |
popularityScore.eligibleRegion |
Ülke | Bu popülerlik puanının geçerli olduğu bölgeler. Popülerlik puanı genel olarak geçerliyse EARTH olarak ayarlayın. Bu özellik varsayılan olarak EARTH şeklinde ayarlanır. Note: Yerele özgü popülerlik, küresel (DÜNYA) popülerliğe göre önceliklidir. |
MusicAlbum
| Mülk | Beklenen Tür | Açıklama |
|---|---|---|
@context |
Metin | Zorunlu: Her zaman ["http://schema.googleapis.com", {"@language": "xx"}] değerine ayarlanır.
|
@type |
Metin | Zorunlu: Albümler için her zaman MusicAlbum olarak ayarlanır. |
@id |
URL | Zorunlu: İçeriğin URI biçimindeki tanımlayıcısı (ör. https://example.com/1234abc).@id aşağıdaki koşulları karşılamalıdır:
url özelliği, tanımlayıcı olarak tüm koşulları karşıladığı için @id olarak öğenin url özelliğini kullanmanızı öneririz. Daha ayrıntılı bilgi için Tanımlayıcı bölümüne bakın. |
url |
URL | Zorunlu: Google'ın, feed'inizdeki içeriği Google'ın veritabanlarındaki içerikle eşleştirmek için kullandığı, içeriğin standart URL'si.url Aşağıdaki şartları karşılamalıdır:
urlTemplate özelliğine bakın. |
name |
Metin | Zorunlu: Albümün adı.
|
byArtist |
MusicGroup | Zorunlu: Bu albümü kaydeden sanatçı veya grup. En azından, sanatçı için kullandığınız benzersiz @id ve sanatçının adını belirtmeniz gerekir. Albümün birden fazla ilişkili sanatçısı varsa byArtist içinde bir değer dizisi sağlayabilirsiniz. |
byArtist.@type |
Metin | Zorunlu: Bu mülk için her zaman MusicGroup olarak ayarlayın. |
byArtist.@id |
URL | Zorunlu: Albümün sanatçısının tanımlayıcısı. @id ile ilgili şartları yukarıda bulabilirsiniz. Bu değer, feed'inizin başka bir yerinde sanatçı/grup için kullandığınız @id ile eşleşmelidir. |
byArtist.name |
Metin | Zorunlu: Sanatçının/grubun adı. |
potentialAction |
ListenAction | Zorunlu: İşlemin ayrıntılarını sağlayan bir işlem işaretleme nesnesi. Ayrıntılar için İşlem işaretleme özellikleri bölümüne bakın.
|
subjectOf |
MusicPlaylist | Varlık temelli işlemler için gereklidir: Varlık temelli işlem ile ilgili ayrıntılar. |
subjectOf.@type |
Metin | Varlık temelli işlemler için zorunludur: Bu özellik için her zaman MusicPlaylist olarak ayarlayın. |
subjectOf.@id |
URL | Varlık temelli işlemler için zorunludur: Varlık temelli işlemin tanımlayıcısı. @id ile ilgili şartları yukarıda bulabilirsiniz. Albümün @id değerinden farklı olmalıdır. |
subjectOf.url |
URL | Varlık temelli işlemler için zorunlu: Varlık temelli işlemin standart URL'si. url ile ilgili şartları yukarıda bulabilirsiniz. Albümün url ile aynıysa bunu atlayabilirsiniz. |
subjectOf.potentialAction |
ListenAction | Öğe tabanlı işlemler için gereklidir: İşlemin ayrıntılarını sağlayan bir işlem işaretleme nesnesi. Ayrıntılar için İşlem işaretleme özellikleri bölümüne bakın.
|
image |
ImageObject | MusicAlbum'u temsil eden resim. Resim işaretleme özelliklerine bakın. |
sameAs |
URL | Albümü tanımlayabilecek bir referans web sayfasının URL'si (ör. albümün Wikipedia sayfası). Bu, url özelliğinden farklı olmalıdır. |
numTracks |
Integer | Bu albümdeki şarkı veya parça sayısı. |
timeRequired |
Metin | Albümün uzunluğu (ISO 8601 biçiminde). |
description |
Metin | Albümün kısa bir açıklaması. 300 karakter sınırı vardır.
|
isFamilyFriendly |
Boole | Bu içeriğin aileye uygun olup olmadığını (yani içeriğin çocuklar dahil bir ailenin tüm üyeleri için uygun olup olmadığını) belirtir. Google ürünleri, çalınacak şarkıyı belirlerken isFamilyFriendly kullanabilir. |
popularityScore |
PopularityScoreSpecification | Google'ın, kullanıcılar için hangi medyanın oynatılacağını belirlemek üzere diğer sinyallerle birlikte kullandığı bir puan. Bu puan, içeriğin kataloğunuzdaki diğer içeriklere kıyasla ne kadar popüler olduğunu gösterir. Bu nedenle, puanın ölçeği feed'lerinizde ve kataloğunuzdaki tüm öğelerde tutarlı olmalıdır. Varsayılan olarak, bir öğenin popülerlik puanı 0'a ayarlanır. |
popularityScore.@type |
Metin | Her zaman PopularityScoreSpecification olarak ayarlanır. |
popularityScore.value |
Number | Varlığın popülerliğini gösteren negatif olmayan bir sayısal değerdir. Puan ne kadar yüksekse popülerlik de o kadar yüksektir. |
popularityScore.eligibleRegion |
Ülke | Bu popülerlik puanının geçerli olduğu bölgeler. Popülerlik puanı genel olarak geçerliyse EARTH olarak ayarlayın. Bu özellik varsayılan olarak EARTH şeklinde ayarlanır. |
MusicRecording
| Mülk | Beklenen Tür | Açıklama |
|---|---|---|
@context |
Metin | Zorunlu: Her zaman ["http://schema.googleapis.com", {"@language": "xx"}] değerine ayarlanır.
|
@type |
Metin | Zorunlu: Şarkılar/parçalar için her zaman MusicRecording olarak ayarlanır. |
@id |
URL | Zorunlu: İçeriğin URI biçimindeki tanımlayıcısı (ör. https://example.com/1234abc).@id aşağıdaki koşulları karşılamalıdır:
url özelliği, tanımlayıcı olarak tüm koşulları karşıladığı için @id olarak öğenin url özelliğini kullanmanızı öneririz. Daha ayrıntılı bilgi için Tanımlayıcı bölümüne bakın. |
url |
URL | Zorunlu: Google'ın, feed'inizdeki içeriği Google'ın veritabanlarındaki içerikle eşleştirmek için kullandığı, içeriğin standart URL'si.url Aşağıdaki şartları karşılamalıdır:
urlTemplate özelliğine bakın. |
name |
Metin | Zorunlu: Şarkının adı.
|
byArtist |
MusicGroup | Zorunlu: Bu şarkıyı kaydeden sanatçı veya grup. En azından, sanatçı için kullandığınız benzersiz @id ve sanatçının adını belirtmeniz gerekir. Şarkının birden fazla ilişkili sanatçısı varsa byArtist içinde bir değer dizisi sağlayabilirsiniz. |
byArtist.@type |
Metin | Zorunlu: Bu mülk için her zaman MusicGroup olarak ayarlayın. |
byArtist.@id |
URL | Zorunlu: Şarkının sanatçısının tanımlayıcısı. @id ile ilgili şartları yukarıda bulabilirsiniz. Bu değer, feed'inizin başka bir yerinde sanatçı/grup için kullandığınız @id ile eşleşmelidir. |
byArtist.name |
Metin | Zorunlu: Sanatçının/grubun adı. |
potentialAction |
ListenAction | Zorunlu: İşlemin ayrıntılarını sağlayan bir işlem işaretleme nesnesi. Ayrıntılar için İşlem işaretleme özellikleri bölümüne bakın.
|
subjectOf |
MusicPlaylist | Varlık temelli işlemler için gereklidir: Varlık temelli işlemle ilgili ayrıntılar |
subjectOf.@type |
Metin | Varlık temelli işlemler için zorunludur: Bu özellik için her zaman MusicPlaylist olarak ayarlayın. |
subjectOf.@id |
URL | Varlık temelli işlemler için zorunludur: Varlık temelli işlemin tanımlayıcısı. @id ile ilgili şartları yukarıda bulabilirsiniz. Şarkının @id değerinden farklı olmalıdır. |
subjectOf.url |
URL | Varlık temelli işlemler için zorunlu: Varlık temelli işlemin standart URL'si. url ile ilgili şartları yukarıda bulabilirsiniz. Şarkının url ile aynıysa bunu atlayabilirsiniz. |
subjectOf.potentialAction |
ListenAction | Öğe tabanlı işlemler için gereklidir: İşlemin ayrıntılarını sağlayan bir işlem işaretleme nesnesi. Ayrıntılar için İşlem işaretleme özellikleri bölümüne bakın.
|
image |
ImageObject | MusicRecording'i temsil eden resim. Resim işaretleme özelliklerine bakın. |
sameAs |
URL | Albümü tanımlayabilecek bir referans web sayfasının URL'si (ör. albümün Wikipedia sayfası). Bu, url özelliğinden farklı olmalıdır. |
inAlbum |
MusicAlbum | Parçanın yer aldığı albüm (varsa) |
inAlbum.@type |
Metin | Bu mülk için her zaman MusicAlbum olarak ayarlayın. |
inAlbum.@id |
URL | Albümün tanımlayıcısıdır. @id ile ilgili şartları yukarıda bulabilirsiniz. Feed'inizin başka bir yerinde albüm için kullandığınız @id ile eşleşmelidir. |
inAlbum.name |
Metin | Albümün adı. |
duration |
Metin | Şarkının süresi (ISO 8601 biçiminde). |
description |
Metin | Şarkının kısa bir açıklaması. 300 karakter sınırı vardır.
|
isFamilyFriendly |
Boole | Bu içeriğin aileye uygun olup olmadığını (yani içeriğin çocuklar dahil bir ailenin tüm üyeleri için uygun olup olmadığını) belirtir. Google ürünleri, çalınacak şarkıyı belirlerken isFamilyFriendly kullanabilir. |
popularityScore |
PopularityScoreSpecification | Google'ın, kullanıcılar için hangi medyanın oynatılacağını belirlemek üzere diğer sinyallerle birlikte kullandığı bir puan. Bu puan, içeriğin kataloğunuzdaki diğer içeriklere kıyasla ne kadar popüler olduğunu gösterir. Bu nedenle, puanın ölçeği feed'lerinizde ve kataloğunuzdaki tüm öğelerde tutarlı olmalıdır. Varsayılan olarak, bir öğenin popülerlik puanı 0'a ayarlanır. |
popularityScore.@type |
Metin | Her zaman PopularityScoreSpecification olarak ayarlanır. |
popularityScore.value |
Number | Varlığın popülerliğini gösteren negatif olmayan bir sayısal değerdir. Puan ne kadar yüksekse popülerlik de o kadar yüksektir. |
popularityScore.eligibleRegion |
Ülke | Bu popülerlik puanının geçerli olduğu bölgeler. Popülerlik puanı genel olarak geçerliyse EARTH olarak ayarlayın. Bu özellik varsayılan olarak EARTH şeklinde ayarlanır. |
Örnekler
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"
}
}
}
}
}
İlgili sayfalar
Bu mülklerle ilgili konular için aşağıdaki sayfalara göz atın: