이 섹션에서는 MusicPlaylist 항목 유형의 콘텐츠 마크업 속성에 관해 자세히 설명합니다.
사양 표
| 속성 | 예상 유형 | 설명 |
|---|---|---|
@context |
텍스트 | 필수 - 항상 ["http://schema.googleapis.com", {"@language": "xx"}]로 설정합니다.
|
@type |
텍스트 | 필수: 믹스의 경우 항상 MusicPlaylist로 설정합니다. |
@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">
|
genre |
텍스트 | 재생목록이 장르 믹스인 경우 필수 - 재생목록이 나타내는 장르와 관련된 키워드 목록입니다. 이 속성이 있으면 이 재생목록을 장르 재생목록으로 만들 것임을 Google에 알립니다. |
numTracks |
정수 | 재생목록이 선별된 믹스인 경우 필수 - 재생목록의 트랙 수입니다. 이 숙박 시설이 있으면 이 재생목록이 직접 선별되었음을 Google에 알립니다. 이 속성이 없으면 재생목록이 자동으로 생성되는 무한 재생목록임을 나타냅니다. |
potentialAction |
ListenAction | 필수: 작업의 세부정보를 제공하는 작업 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
|
image |
ImageObject | 재생목록 또는 음악 믹스를 나타내는 재생목록 이미지입니다. 이미지 마크업 속성을 참고하세요. |
creator |
Organization 또는 Person | 크리에이터의 관심이 높은 경우에 권장됩니다. 이 속성을 사용하여 내 서비스에서 만든 재생목록을 표시하거나 (name 속성이 서비스를 나타내는 Organization으로 입력됨) 내 서비스의 관심도가 높은 사용자 (Person으로 입력되며 관심 사용자를 나타내는 name 속성이 사용됨)를 나타냅니다. |
keywords |
텍스트 | 키워드(예: '록', '팝'), 기분('행복', '기분 좋은'), 활동('운동', '완화') 또는 재생목록과 관련된 기타 용어의 목록 |
description |
텍스트 | 재생목록에 대한 간단한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다.
|
isFamilyFriendly |
Boolean | 콘텐츠가 가족용인지 (즉, 아동을 포함한 모든 가족 구성원에게 적합한 콘텐츠) 여부를 나타냅니다. Google 제품에서는 재생할 노래를 결정할 때 isFamilyFriendly를 사용할 수 있습니다. |
popularityScore |
PopularityScoreSpecification | 강력 추천 이유 Google에서 사용자에게 재생할 미디어를 결정하는 데 사용하는 점수 및 기타 신호입니다. 이 점수는 카탈로그에 있는 다른 콘텐츠와 비교하여 콘텐츠의 인기도를 나타냅니다. 따라서 점수 척도는 카탈로그의 모든 항목 중에서 피드 전체에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다. |
popularityScore.@type |
텍스트 | 항상 PopularityScoreSpecification로 설정합니다. |
popularityScore.value |
숫자 | 항목의 인기도를 나타내는 음수가 아닌 숫자 값입니다. 점수가 높을수록 인기도가 높다는 것을 의미합니다. |
popularityScore.eligibleRegion |
국가 | 이 인기도 점수가 적용되는 지역입니다. 인기도 점수가 전 세계적으로 적용되는 경우 EARTH로 설정합니다. 기본적으로 이 속성은 EARTH로 설정됩니다. Note: 언어별 인기도가 전 세계 (EARTH) 인기도보다 우선 적용됨 |
예
2010년대 팝송을 직접 선별한 재생목록이 포함된 예는 다음과 같습니다.
{
"@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."
}
관련 페이지
이러한 속성과 관련된 주제는 다음 페이지를 확인하세요.