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

このセクションでは、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 テキスト 必須 - アーティストまたはグループの名前。<ph type="x-smartling-placeholder">
    </ph>
  • 複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。
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"}] に設定します。
  • 「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 テキスト 必須 - アルバムの名前。<ph type="x-smartling-placeholder">
    </ph>
  • 複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。
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"}] に設定します。
  • 「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 テキスト 必須 - 曲の名前。<ph type="x-smartling-placeholder">
    </ph>
  • 複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。
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"
        }
      }
    }
  }
}

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