音楽プレイリストのコンテンツ マークアップ プロパティ

このセクションでは、MusicPlaylist エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。

仕様表

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.googleapis.com", {"@language": "xx"}] に設定します。
  • ここで「xx」は、フィード内の文字列の言語を表します。各ルート エンティティ コンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕/吹き替えの言語が英語であっても、名前はスペイン語であると見なされます。
@type テキスト 必須 - ミックスの場合は常に MusicPlaylist に設定します。
@id URL 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。
@id は次の要件を満たす必要があります。
  • カタログ全体でグローバルに一意
  • 静的。ID は、番組の URL プロパティが変更されても、時間が経過しても変化しないものにする必要があります。これは不透明な文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier（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 プロパティを持つ Organization として型付け）またはサービスへの関心が高いユーザー（関心のあるユーザーを示す name プロパティを持つ Person として型付け）によって作成されたプレイリストを示すために使用します。
keywords テキスト キーワード（「ロック」、「ポップス」）、気分（「楽しい」、「物悲しい」）、アクティビティ（「運動」、「癒し」）またはプレイリストに関連するその他の用語のリスト。
description テキスト プレイリストの簡単な説明。300 文字以内。
  • 複数の言語で説明をマークアップするには、配列を使用します。「複数の地域と言語」の例をご覧ください。
isFamilyFriendly ブール値 このコンテンツが家族向けかどうか（つまり、コンテンツが子供を含む家族全員に適しているかどうか）を示します。Google プロダクトでは、再生する曲を決定する際に isFamilyFriendly を使用することがあります。
popularityScore PopularityScoreSpecification 強く推奨理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。
popularityScore.@type テキスト 常に PopularityScoreSpecification に設定。
popularityScore.value 数値 エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。
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."
}

これらのプロパティに関連するトピックについては、次のページを確認してください。