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

이 섹션에서는 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 Organization 또는 Person 크리에이터에 대한 관심도가 높은 경우 권장됩니다. 이 속성을 사용하여 서비스에서 만든 재생목록 (name 속성으로 서비스를 나타내는 조직으로 형식 지정) 또는 서비스에 관심이 많은 사용자 (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."
}

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