このセクションでは、MusicGroup
、MusicAlbum
、MusicRecording
エンティティ タイプのコンテンツ マークアップ プロパティの詳細について説明します。
仕様表
MusicGroup
プロパティ | タイプ | 説明 |
---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.googleapis.com", {"@language": "xx"}] に設定します。
|
@type |
テキスト | 必須 - アーティストとグループの場合、常に MusicGroup に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。(例: https://example.com/1234abc)。@id は次の要件を満たしている必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。 |
url |
URL | 必須 - Google がフィード内のコンテンツと Google のデータベース内のコンテンツを照合するために使用するコンテンツの正規 URL。url は次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - アーティストまたはグループの名前。<ph type="x-smartling-placeholder">
|
potentialAction |
ListenAction | 必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクション マークアップのプロパティをご覧ください。 |
subjectOf |
MusicPlaylist | エンティティ シード アクションでは必須 - エンティティ シード アクションの詳細。 |
subjectOf.@type |
テキスト | エンティティ シード アクションでは必須 - このプロパティでは、常に MusicPlaylist に設定します。 |
subjectOf.@id |
URL | エンティティ シード アクションでは必須 - エンティティ シード アクションの識別子。上記の @id の要件をご覧ください。アーティスト/グループの @id とは異なる必要があります。 |
subjectOf.url |
URL | エンティティ シード アクションでは必須 - エンティティ シード アクションの正規 URL。上記の url の要件をご覧ください。アーティスト/グループの url と同じである場合は省略できます。 |
subjectOf.potentialAction |
ListenAction | エンティティ シード アクションでは必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクション マークアップのプロパティをご覧ください。 |
image |
ImageObject | MusicGroup を表す画像。画像マークアップ プロパティをご覧ください。 |
sameAs |
URL | アーティストを識別できる参照ウェブページの URL。たとえば、アーティストの Wikipedia ページなど。url プロパティとは異なる値を指定する必要があります。 |
description |
テキスト | アーティストの略歴。最大 300 文字。
|
isFamilyFriendly |
ブール値 | このコンテンツが家族向けかどうか(つまり、コンテンツが子供を含む家族全員に適しているかどうか)を示します。Google サービスでは、再生する曲を決定する際に isFamilyFriendly を使用することがあります。 |
popularityScore |
PopularityScoreSpecification | 強く推奨理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。 |
popularityScore.@type |
テキスト | 常に PopularityScoreSpecification に設定します。 |
popularityScore.value |
番号 | エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。 |
popularityScore.eligibleRegion |
国 | この人気度スコアを適用可能な地域。人気スコアがグローバルに適用できる場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。Note: 言語 / 地域固有の人気度はグローバル(EARTH)の人気度よりも優先されます |
MusicAlbum
プロパティ | タイプ | 説明 |
---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.googleapis.com", {"@language": "xx"}] に設定します。
|
@type |
テキスト | 必須 - アルバムは常に MusicAlbum に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。(例: https://example.com/1234abc)。@id は次の要件を満たしている必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。 |
url |
URL | 必須 - Google がフィード内のコンテンツと Google のデータベース内のコンテンツを照合するために使用するコンテンツの正規 URL。url は次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - アルバムの名前。<ph type="x-smartling-placeholder">
|
byArtist |
MusicGroup | 必須 - このアルバムを録音したアーティストまたはグループ。少なくとも、そのアーティストに使用する一意の @id とアーティスト名を指定する必要があります。複数のアーティストがアルバムに参加している場合は、byArtist に値の配列を指定できます。 |
byArtist.@type |
テキスト | 必須 - このプロパティは常に MusicGroup に設定します。 |
byArtist.@id |
URL | 必須 - アルバムのアーティストの識別子。上記の @id の要件をご覧ください。フィード内の他の場所でアーティスト/グループの @id と一致させる必要があります。 |
byArtist.name |
テキスト | 必須 - アーティスト / グループの名前。 |
potentialAction |
ListenAction | 必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクション マークアップのプロパティをご覧ください。 |
subjectOf |
MusicPlaylist | エンティティ シード アクションでは必須 - エンティティ シード アクションの詳細。 |
subjectOf.@type |
テキスト | エンティティ シード アクションでは必須 - このプロパティでは、常に MusicPlaylist に設定します。 |
subjectOf.@id |
URL | エンティティ シード アクションでは必須 - エンティティ シード アクションの識別子。上記の @id の要件をご覧ください。アルバムの @id とは異なる値を指定してください。 |
subjectOf.url |
URL | エンティティ シード アクションでは必須 - エンティティ シード アクションの正規 URL。上記の url の要件をご覧ください。アルバムの url と同じである場合は省略できます。 |
subjectOf.potentialAction |
ListenAction | エンティティ シード アクションでは必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクション マークアップのプロパティをご覧ください。 |
image |
ImageObject | MusicAlbum を表す画像。画像マークアップ プロパティをご覧ください。 |
sameAs |
URL | アルバムを識別できる参照ウェブページの URL。たとえば、アルバムの Wikipedia ページなど。url プロパティとは異なる値を指定する必要があります。 |
numTracks |
整数 | このアルバムの曲またはトラックの数です。 |
timeRequired |
テキスト | ISO 8601 形式のアルバムの長さ。 |
description |
テキスト | アルバムの簡単な説明。最大 300 文字。
|
isFamilyFriendly |
ブール値 | このコンテンツが家族向けかどうか(つまり、コンテンツが子供を含む家族全員に適しているかどうか)を示します。Google サービスでは、再生する曲を決定する際に isFamilyFriendly を使用することがあります。 |
popularityScore |
PopularityScoreSpecification | Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。 |
popularityScore.@type |
テキスト | 常に PopularityScoreSpecification に設定します。 |
popularityScore.value |
番号 | エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。 |
popularityScore.eligibleRegion |
国 | この人気度スコアを適用可能な地域。人気スコアがグローバルに適用できる場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。 |
MusicRecording
プロパティ | タイプ | 説明 |
---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.googleapis.com", {"@language": "xx"}] に設定します。
|
@type |
テキスト | 必須 - 曲/トラックの場合は常に MusicRecording に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。(例: https://example.com/1234abc)。@id は次の要件を満たしている必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。 |
url |
URL | 必須 - Google がフィード内のコンテンツと Google のデータベース内のコンテンツを照合するために使用するコンテンツの正規 URL。url は次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - 曲の名前。<ph type="x-smartling-placeholder">
|
byArtist |
MusicGroup | 必須 - この曲を録音したアーティストまたはグループ。少なくとも、そのアーティストに使用する一意の @id とアーティスト名を指定する必要があります。複数のアーティストが曲に参加している場合は、byArtist に値の配列を指定できます。 |
byArtist.@type |
テキスト | 必須 - このプロパティは常に MusicGroup に設定します。 |
byArtist.@id |
URL | 必須 - 曲のアーティストの識別子。上記の @id の要件をご覧ください。フィード内の他の場所でアーティスト/グループの @id と一致させる必要があります。 |
byArtist.name |
テキスト | 必須 - アーティスト / グループの名前。 |
potentialAction |
ListenAction | 必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクション マークアップのプロパティをご覧ください。 |
subjectOf |
MusicPlaylist | エンティティ シード アクションでは必須 - エンティティ シード アクションの詳細 |
subjectOf.@type |
テキスト | エンティティ シード アクションでは必須 - このプロパティでは、常に MusicPlaylist に設定します。 |
subjectOf.@id |
URL | エンティティ シード アクションでは必須 - エンティティ シード アクションの識別子。上記の @id の要件をご覧ください。曲の @id とは異なる必要があります。 |
subjectOf.url |
URL | エンティティ シード アクションでは必須 - エンティティ シード アクションの正規 URL。上記の url の要件をご覧ください。曲の url と同じである場合は省略できます。 |
subjectOf.potentialAction |
ListenAction | エンティティ シード アクションでは必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクション マークアップのプロパティをご覧ください。 |
image |
ImageObject | MusicRecording を表す画像。画像マークアップ プロパティをご覧ください。 |
sameAs |
URL | アルバムを識別できる参照ウェブページの URL。たとえば、アルバムの Wikipedia ページなど。url プロパティとは異なる値を指定する必要があります。 |
inAlbum |
MusicAlbum | トラックが収録されているアルバム(存在する場合)。 |
inAlbum.@type |
テキスト | このプロパティは常に MusicAlbum に設定します。 |
inAlbum.@id |
URL | アルバムの識別子。上記の @id の要件をご覧ください。フィード内の他の場所でアルバムに使用する @id と一致する必要があります。 |
inAlbum.name |
テキスト | アルバムの名前。 |
duration |
テキスト | ISO 8601 形式の曲の長さ。 |
description |
テキスト | 曲の簡単な説明。最大 300 文字。
|
isFamilyFriendly |
ブール値 | このコンテンツが家族向けかどうか(つまり、コンテンツが子供を含む家族全員に適しているかどうか)を示します。Google サービスでは、再生する曲を決定する際に isFamilyFriendly を使用することがあります。 |
popularityScore |
PopularityScoreSpecification | Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。 |
popularityScore.@type |
テキスト | 常に PopularityScoreSpecification に設定します。 |
popularityScore.value |
番号 | エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。 |
popularityScore.eligibleRegion |
国 | この人気度スコアを適用可能な地域。人気スコアがグローバルに適用できる場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。 |
例
MusicGroup
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicGroup",
"@id":"http://www.example.com/artist/my_favorite_artist/",
"url":"http://www.example.com/artist/my_favorite_artist/",
"sameAs": "http://www.my_favorite_artist.com",
"name":"My Favorite Artist",
"description":"This is my favorite artist.",
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/artist/my_favortie_artist/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 92,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/artist/my_favorite_artist?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/artist_mix/my_favorite_artist/",
"url":"http://www.example.com/artist_mix/my_favorite_artist/",
"name":"My Favorite Artist Mix",
"description":"A playlist of songs similar to My Favorite Artist",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
MusicAlbum
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicAlbum",
"@id":"http://www.example.com/album/my_favorite_album",
"url":"http://www.example.com/album/my_favorite_album",
"name":"My Favorite Album",
"sameAs":"https://en.wikipedia.org/wiki/my_favorite_album_(my_favorite_artist_album)",
"description":"This is my favorite album.",
"datePublished":"2010-08-24",
"numTracks":"12",
"timeRequired":"P44M02S",
"byArtist":{
"@type":"MusicGroup",
"@id": "http://www.example.com/artist/my_favorite_artist/",
"name":"My Favorite Artist"
},
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/album/my_favorite_album/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 87,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/album/my_favorite_album?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/album_mix/my_favorite_album",
"url":"http://www.example.com/album_mix/my_favorite_album",
"name":"My Favorite Album Mix",
"description":"A playlist of songs similar to My Favorite Album",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/album_mix/my_favorite_album?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
MusicRecording
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicRecording",
"@id":"http://www.example.com/track/my_favorite_song",
"url":"http://www.example.com/track/my_favorite_song",
"name":"My Favorite Song",
"sameAs":"https://en.wikipedia.org/wiki/my_favorite_song_(song)",
"description":"This is my favorite song.",
"datePublished":"2010-08-24",
"duration":"PT3M54S",
"byArtist":{
"@type":"MusicGroup",
"@id": "http://www.example.com/artist/my_favorite_song/",
"name":"My Favorite Artist"
},
"inAlbum":{
"@type":"MusicAlbum",
"@id":"http://www.example.com/album/my_favorite_album",
"name":"My Favorite Album"
},
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/track/my_favorite_song/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 97,
"eligibleRegion": "EARTH"
},
"potentialAction": {
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/track/my_favorite_song?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"
]
},
"expectsAcceptanceOf": {
"@type":"Offer",
"category":"subscription",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"subjectOf": {
"@type":"MusicPlaylist",
"@id":"http://www.example.com/track_mix/my_favorite_song",
"url":"http://www.example.com/track_mix/my_favorite_song",
"name":"My Favorite Song Mix",
"description":"A playlist of songs similar to My Favorite Song",
"potentialAction":{
"@type":"ListenAction",
"target": {
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/track_mix/my_favorite_song?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"
]
},
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
}
}
}
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。