Esta seção fornece os detalhes das propriedades de marcação de conteúdo para os tipos de entidade MusicGroup, MusicAlbum e MusicRecording.
Tabela de especificações
MusicGroup
| Propriedade | Tipo esperado | Descrição | 
|---|---|---|
| @context | Texto | Obrigatório: sempre definido como ["http://schema.googleapis.com", {"@language": "xx"}].
 | 
| @type | Texto | Obrigatório: sempre definido como MusicGrouppara artistas e grupos. | 
| @id | URL | Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc. @idprecisa atender aos seguintes requisitos:
 urlde uma entidade atende a todos os requisitos como identificador, recomendamos que você use ourlde uma entidade como@id. Consulte a seção Identificador para mais detalhes. | 
| url | URL | Obrigatório: o URL canônico do conteúdo, que o Google usa para fazer a correspondência entre o conteúdo do seu feed e o conteúdo dos bancos de dados do Google. urlprecisa atender aos seguintes requisitos:
 urlTemplatedo objeto alvo. | 
| name | Texto | Obrigatório: o nome do artista ou grupo. 
 | 
| potentialAction | ListenAction | Obrigatório: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as Propriedades da marcação de ação para mais detalhes. 
 | 
| subjectOf | MusicPlaylist | Obrigatório para ações com dados de entidade: detalhes da ação com dados de entidade. | 
| subjectOf.@type | Texto | Obrigatório para ações iniciadas por entidade: sempre defina como MusicPlaylistpara essa propriedade. | 
| subjectOf.@id | URL | Obrigatório para ações com dados de entidades: o identificador da ação com dados de entidades. Consulte os requisitos para @idacima. Ele precisa ser diferente do@iddo artista/grupo. | 
| subjectOf.url | URL | Obrigatório para ações com sementes de entidade: é o URL canônico da ação com sementes de entidade. Consulte os requisitos para urlacima. Você pode omitir esse campo se ele for igual aourldo artista/grupo. | 
| subjectOf.potentialAction | ListenAction | Obrigatório para ações iniciadas por entidade: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as Propriedades da marcação de ação para mais detalhes. 
 | 
| image | ImageObject | Imagem que representa o MusicGroup. Consulte Propriedades de marcação de imagem. | 
| sameAs | URL | Um URL de uma página da Web de referência que possa identificar o artista, por exemplo, a página do artista na Wikipédia. Ele precisa ser diferente da propriedade url. | 
| description | Texto | Uma breve biografia do artista. Limite de 300 caracteres. 
 | 
| isFamilyFriendly | Booleano | Indica se o conteúdo é adequado para toda a família, ou seja, se é adequado para todos os membros da família, incluindo crianças. Os produtos do Google podem usar isFamilyFriendlyao determinar uma música para tocar. | 
| popularityScore | PopularityScoreSpecification | Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia será reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos no seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0. | 
| popularityScore.@type | Texto | Sempre defina como PopularityScoreSpecification. | 
| popularityScore.value | Número | Um valor numérico não negativo que indica a popularidade da entidade. Quanto maior a pontuação, maior a popularidade. | 
| popularityScore.eligibleRegion | País | Regiões em que esse índice de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida comoEARTH.Note: A popularidade específica da localidade tem precedência sobre a global (EARTH) | 
MusicAlbum
| Propriedade | Tipo esperado | Descrição | 
|---|---|---|
| @context | Texto | Obrigatório: sempre definido como ["http://schema.googleapis.com", {"@language": "xx"}].
 | 
| @type | Texto | Obrigatório: sempre definido como MusicAlbumpara álbuns. | 
| @id | URL | Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc. @idprecisa atender aos seguintes requisitos:
 urlde uma entidade atende a todos os requisitos como identificador, recomendamos que você use ourlde uma entidade como@id. Consulte a seção Identificador para mais detalhes. | 
| url | URL | Obrigatório: o URL canônico do conteúdo, que o Google usa para fazer a correspondência entre o conteúdo do seu feed e o conteúdo dos bancos de dados do Google. urlprecisa atender aos seguintes requisitos:
 urlTemplatedo objeto alvo. | 
| name | Texto | Obrigatório: o nome do álbum. 
 | 
| byArtist | MusicGroup | Obrigatório: o artista ou grupo que gravou o álbum. No mínimo, você precisa especificar o @idexclusivo que usa para esse artista e o nome dele. Se o álbum tiver vários artistas associados, você poderá fornecer uma matriz de valores em byArtist. | 
| byArtist.@type | Texto | Obrigatório: sempre definido como MusicGrouppara essa propriedade. | 
| byArtist.@id | URL | Obrigatório: o identificador do artista do álbum. Consulte os requisitos para @idacima. Ele precisa corresponder ao@idusado para o artista/grupo em outro lugar do seu feed. | 
| byArtist.name | Texto | Obrigatório: o nome do artista/grupo. | 
| potentialAction | ListenAction | Obrigatório: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as Propriedades da marcação de ação para mais detalhes. 
 | 
| subjectOf | MusicPlaylist | Obrigatório para ações com dados de entidade: detalhes da ação com dados de entidade. | 
| subjectOf.@type | Texto | Obrigatório para ações iniciadas por entidade: sempre defina como MusicPlaylistpara essa propriedade. | 
| subjectOf.@id | URL | Obrigatório para ações com dados de entidades: o identificador da ação com dados de entidades. Consulte os requisitos para @idacima. Ele precisa ser diferente do@iddo álbum. | 
| subjectOf.url | URL | Obrigatório para ações com semente de entidade: o URL canônico da ação com semente de entidade. Consulte os requisitos para urlacima. Você pode deixar isso de fora se ele for igual aourldo álbum. | 
| subjectOf.potentialAction | ListenAction | Obrigatório para ações iniciadas por entidade: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as Propriedades da marcação de ação para mais detalhes. 
 | 
| image | ImageObject | Imagem que representa o álbum de música. Consulte Propriedades de marcação de imagem. | 
| sameAs | URL | Um URL de uma página da Web de referência que pode identificar o álbum. Por exemplo, a página da Wikipédia do álbum. Ele precisa ser diferente da propriedade url. | 
| numTracks | Número inteiro | O número de músicas ou faixas do álbum. | 
| timeRequired | Texto | A duração do álbum, no formato ISO 8601. | 
| description | Texto | Uma breve descrição do álbum. Limite de 300 caracteres. 
 | 
| isFamilyFriendly | Booleano | Indica se o conteúdo é adequado para toda a família, ou seja, se é adequado para todos os membros da família, incluindo crianças. Os produtos do Google podem usar isFamilyFriendlyao determinar uma música para tocar. | 
| popularityScore | PopularityScoreSpecification | Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia será reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos no seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0. | 
| popularityScore.@type | Texto | Sempre defina como PopularityScoreSpecification. | 
| popularityScore.value | Número | Um valor numérico não negativo que indica a popularidade da entidade. Quanto maior a pontuação, maior a popularidade. | 
| popularityScore.eligibleRegion | País | Regiões em que esse índice de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida comoEARTH. | 
MusicRecording
| Propriedade | Tipo esperado | Descrição | 
|---|---|---|
| @context | Texto | Obrigatório: sempre definido como ["http://schema.googleapis.com", {"@language": "xx"}].
 | 
| @type | Texto | Obrigatório: sempre definido como MusicRecordingpara músicas/faixas. | 
| @id | URL | Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc. @idprecisa atender aos seguintes requisitos:
 urlde uma entidade atende a todos os requisitos como identificador, recomendamos que você use ourlde uma entidade como@id. Consulte a seção Identificador para mais detalhes. | 
| url | URL | Obrigatório: o URL canônico do conteúdo, que o Google usa para fazer a correspondência entre o conteúdo do seu feed e o conteúdo dos bancos de dados do Google. urlprecisa atender aos seguintes requisitos:
 urlTemplatedo objeto alvo. | 
| name | Texto | Obrigatório: o nome da música. 
 | 
| byArtist | MusicGroup | Obrigatório: o artista ou grupo que gravou a música. No mínimo, você precisa especificar o @idexclusivo que usa para esse artista e o nome dele. Se a música tiver vários artistas associados, forneça uma matriz de valores em byArtist. | 
| byArtist.@type | Texto | Obrigatório: sempre definido como MusicGrouppara essa propriedade. | 
| byArtist.@id | URL | Obrigatório: o identificador do artista da música. Consulte os requisitos para @idacima. Ele precisa corresponder ao@idusado para o artista/grupo em outro lugar do seu feed. | 
| byArtist.name | Texto | Obrigatório: o nome do artista/grupo. | 
| potentialAction | ListenAction | Obrigatório: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as Propriedades da marcação de ação para mais detalhes. 
 | 
| subjectOf | MusicPlaylist | Obrigatório para ações com dados de entidades: detalhes da ação com dados de entidade | 
| subjectOf.@type | Texto | Obrigatório para ações iniciadas por entidade: sempre defina como MusicPlaylistpara essa propriedade. | 
| subjectOf.@id | URL | Obrigatório para ações com dados de entidades: o identificador da ação com dados de entidades. Consulte os requisitos para @idacima. Ele precisa ser diferente do@idda música. | 
| subjectOf.url | URL | Obrigatório para ações com semente de entidade: o URL canônico da ação com semente de entidade. Consulte os requisitos para urlacima. Você pode deixar isso de fora se for igual aourlda música. | 
| subjectOf.potentialAction | ListenAction | Obrigatório para ações iniciadas por entidade: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as Propriedades da marcação de ação para mais detalhes. 
 | 
| image | ImageObject | Imagem que representa a gravação de música. Consulte Propriedades de marcação de imagem. | 
| sameAs | URL | Um URL de uma página da Web de referência que pode identificar o álbum. Por exemplo, a página da Wikipédia do álbum. Ele precisa ser diferente da propriedade url. | 
| inAlbum | MusicAlbum | O álbum em que a música aparece, se houver. | 
| inAlbum.@type | Texto | Sempre defina como MusicAlbumpara essa propriedade. | 
| inAlbum.@id | URL | O identificador do álbum. Consulte os requisitos para @idacima. Ele precisa corresponder ao@idusado para o álbum em outro lugar do feed. | 
| inAlbum.name | Texto | O nome do álbum. | 
| duration | Texto | A duração da música, no formato ISO 8601. | 
| description | Texto | Uma breve descrição da música. Limite de 300 caracteres. 
 | 
| isFamilyFriendly | Booleano | Indica se o conteúdo é adequado para toda a família, ou seja, se é adequado para todos os membros da família, incluindo crianças. Os produtos do Google podem usar isFamilyFriendlyao determinar uma música para tocar. | 
| popularityScore | PopularityScoreSpecification | Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia será reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos no seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0. | 
| popularityScore.@type | Texto | Sempre defina como PopularityScoreSpecification. | 
| popularityScore.value | Número | Um valor numérico não negativo que indica a popularidade da entidade. Quanto maior a pontuação, maior a popularidade. | 
| popularityScore.eligibleRegion | País | Regiões em que esse índice de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida comoEARTH. | 
Exemplos
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"
        }
      }
    }
  }
}
Páginas relacionadas
Confira as páginas a seguir para ver os tópicos relacionados a essas propriedades: