음악 재생목록의 콘텐츠 마크업 속성

이 섹션에서는 MusicPlaylist 항목 유형의 콘텐츠 마크업 속성에 관해 자세히 설명합니다.

사양 표

속성 예상 유형 설명
@context 텍스트 필수 - 항상 ["http://schema.googleapis.com", {"@language": "xx"}]로 설정합니다.
  • 여기서 'xx'는 피드의 문자열 언어를 나타냅니다. 각 루트 항목 컨텍스트는 @language를 BCP 47 형식 형식의 적절한 언어 코드로 설정해야 합니다. 예를 들어 언어가 스페인어로 설정되어 있으면 자막 언어가 영어인 경우에도 이름은 스페인어로 간주됩니다.
@type 텍스트 필수: 믹스의 경우 항상 MusicPlaylist로 설정합니다.
@id URL 필수사항 - URI 형식의 콘텐츠 식별자입니다. 예를 들어 https://example.com/1234abc가 있습니다.
@id은 다음 요구사항을 충족해야 합니다.
  • 카탈로그 전체에서 전역적으로 고유함
  • 정적이며, ID는 안정적이어야 하며 프로그램의 URL 속성이 변경되더라도 시간이 지남에 따라 변경되지 않아야 합니다. 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (URI) 형식
  • @id 값에 사용되는 도메인은 조직에서 소유해야 합니다.
항목의 url는 식별자로서의 모든 요구사항을 충족하므로 항목의 url@id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
url URL 필수 - 콘텐츠의 표준 URL입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시켜야 합니다.
url은 다음 요구사항을 충족해야 합니다.
  • url는 전역적으로 고유해야 합니다.
  • url에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.
  • url에서 페이월로 차단되지 않은 콘텐츠 설명 페이지를 가리켜야 합니다.
재생의 딥 링크target 객체의 urlTemplate 속성을 대신 참고하세요.
name 텍스트 필수사항 - 재생목록의 이름입니다(예: '펑키 재즈 믹스'). <ph type="x-smartling-placeholder">
    </ph>
  • 배열을 사용하여 다양한 언어로 된 이름을 나열합니다. 여러 지역 및 언어 예를 참고하세요.
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."
}

이러한 속성과 관련된 주제는 다음 페이지를 확인하세요.