이 섹션에서는 MusicGroup
, MusicAlbum
, MusicRecording
항목 유형의 콘텐츠 마크업 속성에 관해 자세히 설명합니다.
사양 표
MusicGroup
속성 | 예상 유형 | 설명 |
---|---|---|
@context |
텍스트 | 필수 - 항상 ["http://schema.googleapis.com", {"@language": "xx"}] 로 설정합니다.
|
@type |
텍스트 | 필수 - 아티스트 및 그룹의 경우 항상 MusicGroup 로 설정됩니다. |
@id |
URL | 필수사항 - URI 형식의 콘텐츠 식별자입니다. 예를 들어 https://example.com/1234abc가 있습니다.@id 은 다음 요구사항을 충족해야 합니다.
url 는 식별자로서의 모든 요구사항을 충족하므로 항목의 url 를 @id 로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요. |
url |
URL | 필수 - 콘텐츠의 표준 URL입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시켜야 합니다.url 은 다음 요구사항을 충족해야 합니다.
urlTemplate 속성을 대신 참고하세요. |
name |
텍스트 | 필수 - 아티스트 또는 그룹의 이름입니다. <ph type="x-smartling-placeholder">
|
potentialAction |
ListenAction | 필수: 작업의 세부정보를 제공하는 작업 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
|
subjectOf |
MusicPlaylist | 항목 시드 작업에 필수 - 항목 시드 작업의 세부정보입니다. |
subjectOf.@type |
텍스트 | 항목 시드 작업에 필수 - 이 속성에 대해 항상 MusicPlaylist 로 설정됩니다. |
subjectOf.@id |
URL | 항목 시드 작업에 필수 - 항목 시드 작업의 식별자입니다. 위의 @id 요구사항을 참고하세요. 아티스트/그룹의 @id 와 구분되어야 합니다. |
subjectOf.url |
URL | 항목 시드 작업에 필수 - 항목 시드 작업의 표준 URL입니다. 위의 url 요구사항을 참고하세요. 아티스트/그룹의 url 와 동일하면 생략해도 됩니다. |
subjectOf.potentialAction |
ListenAction | 항목 시드 작업에 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
|
image |
ImageObject | MusicGroup을 나타내는 이미지입니다. 이미지 마크업 속성을 참고하세요. |
sameAs |
URL | 아티스트를 식별할 수 있는 참조 웹페이지에 대한 URL 아티스트의 위키백과 페이지를 예로 들 수 있습니다. 이는 url 속성과 구분되어야 합니다. |
description |
텍스트 | 아티스트의 간단한 약력 글자 수 제한은 300자(영문 기준)입니다.
|
isFamilyFriendly |
Boolean | 콘텐츠가 가족용인지 (즉, 아동을 포함한 모든 가족 구성원에게 적합한 콘텐츠) 여부를 나타냅니다. Google 제품에서는 재생할 노래를 결정할 때 isFamilyFriendly 를 사용할 수 있습니다. |
popularityScore |
PopularityScoreSpecification | 강력 추천 이유 Google에서 사용자에게 재생할 미디어를 결정하는 데 사용하는 점수 및 기타 신호입니다. 이 점수는 카탈로그에 있는 다른 콘텐츠와 비교하여 콘텐츠의 인기도를 나타냅니다. 따라서 점수 척도는 카탈로그의 모든 항목 중에서 피드 전체에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다. |
popularityScore.@type |
텍스트 | 항상 PopularityScoreSpecification 로 설정합니다. |
popularityScore.value |
숫자 | 항목의 인기도를 나타내는 음수가 아닌 숫자 값입니다. 점수가 높을수록 인기도가 높다는 것을 의미합니다. |
popularityScore.eligibleRegion |
국가 | 이 인기도 점수가 적용되는 지역입니다. 인기도 점수가 전 세계적으로 적용되는 경우 EARTH 로 설정합니다. 기본적으로 이 속성은 EARTH 로 설정됩니다. Note: 언어별 인기도가 전 세계 (EARTH) 인기도보다 우선 적용됨 |
MusicAlbum
속성 | 예상 유형 | 설명 |
---|---|---|
@context |
텍스트 | 필수 - 항상 ["http://schema.googleapis.com", {"@language": "xx"}] 로 설정합니다.
|
@type |
텍스트 | 필수 - 앨범의 경우 항상 MusicAlbum 로 설정합니다. |
@id |
URL | 필수사항 - URI 형식의 콘텐츠 식별자입니다. 예를 들어 https://example.com/1234abc가 있습니다.@id 은 다음 요구사항을 충족해야 합니다.
url 는 식별자로서의 모든 요구사항을 충족하므로 항목의 url 를 @id 로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요. |
url |
URL | 필수 - 콘텐츠의 표준 URL입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시켜야 합니다.url 은 다음 요구사항을 충족해야 합니다.
urlTemplate 속성을 대신 참고하세요. |
name |
텍스트 | 필수 - 앨범 이름 <ph type="x-smartling-placeholder">
|
byArtist |
MusicGroup | 필수 - 이 앨범을 녹음한 아티스트 또는 그룹입니다. 최소한 해당 아티스트에 사용하는 고유한 @id 와 아티스트 이름을 지정해야 합니다. 앨범에 연결된 아티스트가 여러 명인 경우 byArtist에 일련의 값을 제공할 수 있습니다. |
byArtist.@type |
텍스트 | 필수: 이 속성의 경우 항상 MusicGroup 로 설정됩니다. |
byArtist.@id |
URL | 필수 - 앨범 아티스트에 대한 식별자입니다. 위의 @id 요구사항을 참고하세요. 피드의 다른 위치에 있는 아티스트/그룹에 대해 사용한 @id 과 일치해야 합니다. |
byArtist.name |
텍스트 | 필수사항 - 아티스트/그룹의 이름 |
potentialAction |
ListenAction | 필수: 작업의 세부정보를 제공하는 작업 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
|
subjectOf |
MusicPlaylist | 항목 시드 작업에 필수 - 항목 시드 작업의 세부정보입니다. |
subjectOf.@type |
텍스트 | 항목 시드 작업에 필수 - 이 속성에 대해 항상 MusicPlaylist 로 설정됩니다. |
subjectOf.@id |
URL | 항목 시드 작업에 필수 - 항목 시드 작업의 식별자입니다. 위의 @id 요구사항을 참고하세요. 앨범의 @id 와 구분되어야 합니다. |
subjectOf.url |
URL | 항목 시드 작업에 필수 - 항목 시드 작업의 표준 URL입니다. 위의 url 요구사항을 참고하세요. 앨범의 url 과 동일하면 생략해도 됩니다. |
subjectOf.potentialAction |
ListenAction | 항목 시드 작업에 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
|
image |
ImageObject | Music앨범을 나타내는 이미지입니다. 이미지 마크업 속성을 참고하세요. |
sameAs |
URL | 앨범을 식별할 수 있는 참조 웹페이지에 대한 URL (예: 앨범의 위키백과 페이지) 이는 url 속성과 구분되어야 합니다. |
numTracks |
정수 | 이 앨범의 노래 또는 트랙 수입니다. |
timeRequired |
텍스트 | 앨범의 길이로, ISO 8601 형식으로 나타냅니다. |
description |
텍스트 | 앨범에 대한 간략한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다.
|
isFamilyFriendly |
Boolean | 콘텐츠가 가족용인지 (즉, 아동을 포함한 모든 가족 구성원에게 적합한 콘텐츠) 여부를 나타냅니다. Google 제품에서는 재생할 노래를 결정할 때 isFamilyFriendly 를 사용할 수 있습니다. |
popularityScore |
PopularityScoreSpecification | Google에서 사용자에게 재생할 미디어를 결정하는 데 사용하는 점수 및 기타 신호입니다. 이 점수는 카탈로그에 있는 다른 콘텐츠와 비교하여 콘텐츠의 인기도를 나타냅니다. 따라서 점수 척도는 카탈로그의 모든 항목 중에서 피드 전체에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다. |
popularityScore.@type |
텍스트 | 항상 PopularityScoreSpecification 로 설정합니다. |
popularityScore.value |
숫자 | 항목의 인기도를 나타내는 음수가 아닌 숫자 값입니다. 점수가 높을수록 인기도가 높다는 것을 의미합니다. |
popularityScore.eligibleRegion |
국가 | 이 인기도 점수가 적용되는 지역입니다. 인기도 점수가 전 세계적으로 적용되는 경우 EARTH 로 설정합니다. 기본적으로 이 속성은 EARTH 로 설정됩니다. |
MusicRecording
속성 | 예상 유형 | 설명 |
---|---|---|
@context |
텍스트 | 필수 - 항상 ["http://schema.googleapis.com", {"@language": "xx"}] 로 설정합니다.
|
@type |
텍스트 | 필수 - 노래/트랙의 경우 항상 MusicRecording 로 설정합니다. |
@id |
URL | 필수사항 - URI 형식의 콘텐츠 식별자입니다. 예를 들어 https://example.com/1234abc가 있습니다.@id 은 다음 요구사항을 충족해야 합니다.
url 는 식별자로서의 모든 요구사항을 충족하므로 항목의 url 를 @id 로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요. |
url |
URL | 필수 - 콘텐츠의 표준 URL입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시켜야 합니다.url 은 다음 요구사항을 충족해야 합니다.
urlTemplate 속성을 대신 참고하세요. |
name |
텍스트 | 필수 - 노래 제목 <ph type="x-smartling-placeholder">
|
byArtist |
MusicGroup | 필수 - 이 노래를 녹음한 아티스트 또는 그룹입니다. 최소한 해당 아티스트에 사용하는 고유한 @id 와 아티스트 이름을 지정해야 합니다. 노래에 관련된 아티스트가 여러 명인 경우 byArtist에 일련의 값을 제공할 수 있습니다. |
byArtist.@type |
텍스트 | 필수: 이 속성의 경우 항상 MusicGroup 로 설정됩니다. |
byArtist.@id |
URL | 필수 - 노래의 아티스트 식별자입니다. 위의 @id 요구사항을 참고하세요. 피드의 다른 위치에 있는 아티스트/그룹에 대해 사용한 @id 과 일치해야 합니다. |
byArtist.name |
텍스트 | 필수사항 - 아티스트/그룹의 이름 |
potentialAction |
ListenAction | 필수: 작업의 세부정보를 제공하는 작업 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
|
subjectOf |
MusicPlaylist | 항목 시드 작업에 필수 - 항목 시드 작업의 세부정보 |
subjectOf.@type |
텍스트 | 항목 시드 작업에 필수 - 이 속성에 대해 항상 MusicPlaylist 로 설정됩니다. |
subjectOf.@id |
URL | 항목 시드 작업에 필수 - 항목 시드 작업의 식별자입니다. 위의 @id 요구사항을 참고하세요. 노래의 @id 과 구분되어야 합니다. |
subjectOf.url |
URL | 항목 시드 작업에 필수 - 항목 시드 작업의 표준 URL입니다. 위의 url 요구사항을 참고하세요. 노래의 url 과 동일하면 생략해도 됩니다. |
subjectOf.potentialAction |
ListenAction | 항목 시드 작업에 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
|
image |
ImageObject | MusicRecording을 나타내는 이미지입니다. 이미지 마크업 속성을 참고하세요. |
sameAs |
URL | 앨범을 식별할 수 있는 참조 웹페이지에 대한 URL (예: 앨범의 위키백과 페이지) 이는 url 속성과 구분되어야 합니다. |
inAlbum |
MusicAlbum | 트랙이 표시되는 앨범입니다(있는 경우). |
inAlbum.@type |
텍스트 | 이 속성의 경우 항상 MusicAlbum 로 설정됩니다. |
inAlbum.@id |
URL | 앨범의 식별자입니다. 위의 @id 요구사항을 참고하세요. 피드의 다른 위치에서 앨범에 사용하는 @id 와 일치해야 합니다. |
inAlbum.name |
텍스트 | 앨범 이름입니다. |
duration |
텍스트 | 노래의 길이입니다(ISO 8601 형식으로 표시). |
description |
텍스트 | 노래에 대한 간단한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다.
|
isFamilyFriendly |
Boolean | 콘텐츠가 가족용인지 (즉, 아동을 포함한 모든 가족 구성원에게 적합한 콘텐츠) 여부를 나타냅니다. Google 제품에서는 재생할 노래를 결정할 때 isFamilyFriendly 를 사용할 수 있습니다. |
popularityScore |
PopularityScoreSpecification | Google에서 사용자에게 재생할 미디어를 결정하는 데 사용하는 점수 및 기타 신호입니다. 이 점수는 카탈로그에 있는 다른 콘텐츠와 비교하여 콘텐츠의 인기도를 나타냅니다. 따라서 점수 척도는 카탈로그의 모든 항목 중에서 피드 전체에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다. |
popularityScore.@type |
텍스트 | 항상 PopularityScoreSpecification 로 설정합니다. |
popularityScore.value |
숫자 | 항목의 인기도를 나타내는 음수가 아닌 숫자 값입니다. 점수가 높을수록 인기도가 높다는 것을 의미합니다. |
popularityScore.eligibleRegion |
국가 | 이 인기도 점수가 적용되는 지역입니다. 인기도 점수가 전 세계적으로 적용되는 경우 EARTH 로 설정합니다. 기본적으로 이 속성은 EARTH 로 설정됩니다. |
예
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"
}
}
}
}
}
관련 페이지
이러한 속성과 관련된 주제는 다음 페이지를 확인하세요.