アーティスト、アルバム、曲のコンテンツ マークアップ プロパティ

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

仕様表

MusicGroup

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.googleapis.com", {"@language": "xx"}] に設定します。
  • 「xx」は、フィード内の文字列の言語を表します。各ルート エンティティ コンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕/吹き替えの言語が英語であっても、名前はスペイン語であると想定されます。
@type テキスト 必須 - アーティストまたはグループの場合、常に MusicGroup に設定します。
@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 テキスト 必須 - アーティスト / グループの名前。
  • 複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。
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 テキスト アーティストの略歴。全角 150(半角 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"}] に設定します。
  • 「xx」は、フィード内の文字列の言語を表します。各ルート エンティティ コンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕/吹き替えの言語が英語であっても、名前はスペイン語であると想定されます。
@type テキスト 必須 - アルバムの場合、常に MusicAlbum に設定します。
@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 テキスト 必須 - アルバムのタイトル。
  • 複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。
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 テキスト アルバムの簡単な説明。全角 150(半角 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"}] に設定します。
  • 「xx」は、フィード内の文字列の言語を表します。各ルート エンティティ コンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕/吹き替えの言語が英語であっても、名前はスペイン語であると想定されます。
@type テキスト 必須 - 曲/トラックの場合、常に MusicRecording に設定します。
@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 テキスト 必須 - 曲名。
  • 複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。
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 テキスト 曲の簡単な説明。全角 150(半角 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"
        }
      }
    }
  }
}

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