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

이 섹션에서는 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 필수 - Google에서 피드의 콘텐츠를 Google의 데이터베이스 콘텐츠와 일치시키는 데 사용하는 콘텐츠의 표준 URL입니다.
url에서 다음 요구사항을 충족해야 합니다.
  • url 필드는 전역적으로 고유해야 합니다.
  • url에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.
  • url는 페이월으로 차단되지 않은 콘텐츠 설명 페이지를 가리켜야 합니다.
재생의 딥 링크타겟 객체의 urlTemplate 속성을 대신 참고하세요.
name 텍스트 필수 - 재생목록의 이름입니다(예: "Funky Jazz Mix").
  • 배열을 사용하여 다양한 언어로 이름을 나열합니다. 여러 지역 및 언어의 예를 참고하세요.
genre 텍스트 재생목록이 장르 믹스인 경우 필수 - 재생목록이 나타내는 장르와 관련된 키워드 목록입니다. 이 속성이 있으면 Google에 이 재생목록을 장르 재생목록으로 지정하려고 한다는 신호입니다.
numTracks 정수 재생목록이 선별된 믹스인 경우 필수 - 재생목록의 트랙 수입니다. 이 속성이 있으면 이 재생목록이 직접 선별되었음을 Google에 알릴 수 있습니다. 이 속성이 없으면 재생목록이 자동 생성된 무제한 재생목록이라는 의미입니다.
potentialAction ListenAction 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
image ImageObject 재생목록 또는 음악 믹스를 나타내는 재생목록 이미지입니다. 이미지 마크업 속성을 참고하세요.
creator 조직 또는 사용자 크리에이터의 관심도가 높은 경우 권장됩니다. 이 속성을 사용하여 서비스에서 만든 재생목록 (서비스를 나타내는 name 속성이 있는 조직으로 입력) 또는 서비스의 중요도가 높은 사용자 (관심 있는 사용자를 나타내는 name 속성이 있는 사람으로 입력)를 표시합니다.
keywords 텍스트 키워드 목록(‘록’, ‘팝’).
description 텍스트 재생목록에 대한 간단한 설명입니다. 글자수 제한은 300자(영문 기준)입니다.
  • 배열을 사용하여 설명을 여러 언어로 마크업합니다. 여러 지역 및 언어의 예를 참고하세요.
isFamilyFriendly Boolean 콘텐츠가 가족에 적합한지 여부를 나타냅니다 (즉, 아동을 포함한 모든 가족 구성원에게 적합한 콘텐츠). Google 제품에서 재생할 노래를 결정할 때 isFamilyFriendly를 사용할 수 있습니다.
popularityScore 인기도 점수 사양 적극 권장되는 이유 Google에서 사용자에게 재생할 미디어를 결정하는 데 사용하는 점수와 기타 신호가 포함됩니다. 이 점수는 카탈로그에 있는 다른 콘텐츠와 비교한 콘텐츠의 인기도를 나타냅니다. 따라서 카탈로그의 모든 항목에서 점수의 척도가 피드 전반에서 일관적이어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다.
popularityScore.@type 텍스트 항상 PopularityScoreSpecification으로 설정합니다.
popularityScore.value Number 항목의 인기도를 나타내는 음수가 아닌 숫자 값입니다. 점수가 높을수록 인기도도 높습니다.
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."
}

이러한 속성과 관련된 주제를 알아보려면 다음 페이지를 참고하세요.