このセクションでは、MusicPlaylist エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。
仕様表
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.googleapis.com", {"@language": "xx"}] に設定します。
|
@type |
テキスト | 必須 - ミックスの場合は常に MusicPlaylist に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。（例: https://example.com/1234abc）。@id は次の要件を満たしている必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。 |
url |
URL | 必須 - Google がフィード内のコンテンツと Google のデータベース内のコンテンツを照合するために使用するコンテンツの正規 URL。url は次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - プレイリストの名前（例: Funky Jazz Mix）。<ph type="x-smartling-placeholder">
|
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."
}
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。