Propriedades de marcação de conteúdo de artistas, álbuns e músicas

Esta seção fornece detalhes sobre as propriedades de marcação de conteúdo para os tipos de entidade MusicGroup, MusicAlbum e MusicRecording.

Tabela de especificação

MusicGroup

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.googleapis.com", {"@language": "xx"}].
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem seja inglês.
@type Texto Obrigatório: sempre definido como MusicGroup para artistas e grupos.
@id URL Obrigatório: o identificador do conteúdo no formato URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em todo o catálogo
  • Estático. O ID precisa ser estável e não pode ser alterado ao longo do tempo, mesmo que a propriedade "url" do programa mude. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • Na forma de um identificador uniforme de recursos (URI)
  • O domínio usado para o valor @id precisa ser de propriedade da sua organização.
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url de 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 corresponder o conteúdo do seu feed com o conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico funcional que o Google possa rastrear.
  • url precisa apontar para uma página de descrição de conteúdo que não esteja bloqueada por um paywall.
Para o link direto de reprodução, consulte a propriedade urlTemplate do objeto target.
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 de marcação de ação para mais detalhes.
subjectOf MusicPlaylist Obrigatório para ações baseadas em entidades: detalhes da ação baseada em entidades.
subjectOf.@type Texto Obrigatório para ações baseadas em entidades: sempre defina como MusicPlaylist para essa propriedade.
subjectOf.@id URL Obrigatório para ações baseadas em entidades: o identificador da ação baseada em entidades. Consulte os requisitos para @id acima. Ele precisa ser diferente do @id do artista/grupo.
subjectOf.url URL Obrigatório para ações baseadas em entidades: o URL canônico da ação baseada em entidades. Consulte os requisitos para url acima. Você pode deixar isso de fora se for igual ao url do artista/grupo.
subjectOf.potentialAction ListenAction Obrigatório para ações baseadas em entidades: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as propriedades de marcação de ação para mais detalhes.
image ImageObject Imagem que representa o MusicGroup. Consulte Propriedades de marcação de imagem.
sameAs URL É o URL de uma página da Web de referência que pode identificar o artista, por exemplo, a página da Wikipédia dele. 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 a família (ou seja, adequado para todos os membros de uma família, incluindo crianças). Os produtos do Google podem usar o isFamilyFriendly ao determinar uma música para tocar.
popularityScore PopularityScoreSpecification Altamente recomendável Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia reproduzir para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros itens do seu catálogo. Portanto, a escala da pontuação precisa ser consistente em todos os seus feeds e entre todas as entidades do 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. Uma pontuação mais alta significa maior popularidade.
popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
Note: A popularidade específica da localidade tem precedência sobre a popularidade global (TERRA)

MusicAlbum

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.googleapis.com", {"@language": "xx"}].
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem seja inglês.
@type Texto Obrigatório: sempre definido como MusicAlbum para álbuns.
@id URL Obrigatório: o identificador do conteúdo no formato URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em todo o catálogo
  • Estático. O ID precisa ser estável e não pode ser alterado ao longo do tempo, mesmo que a propriedade "url" do programa mude. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • Na forma de um identificador uniforme de recursos (URI)
  • O domínio usado para o valor @id precisa ser de propriedade da sua organização.
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url de 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 corresponder o conteúdo do seu feed com o conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico funcional que o Google possa rastrear.
  • url precisa apontar para uma página de descrição de conteúdo que não esteja bloqueada por um paywall.
Para o link direto de reprodução, consulte a propriedade urlTemplate do objeto target.
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 @id exclusivo usado para o 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 MusicGroup para essa propriedade.
byArtist.@id URL Obrigatório: o identificador do artista do álbum. Consulte os requisitos para @id acima. Ele precisa corresponder ao @id usado para o artista/grupo em outro lugar do 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 de marcação de ação para mais detalhes.
subjectOf MusicPlaylist Obrigatório para ações baseadas em entidades: detalhes da ação baseada em entidades.
subjectOf.@type Texto Obrigatório para ações baseadas em entidades: sempre defina como MusicPlaylist para essa propriedade.
subjectOf.@id URL Obrigatório para ações baseadas em entidades: o identificador da ação baseada em entidades. Consulte os requisitos para @id acima. Ele precisa ser diferente do @id do álbum.
subjectOf.url URL Obrigatório para ações baseadas em entidades: o URL canônico da ação baseada em entidades. Consulte os requisitos para url acima. Você pode omitir essa informação se ela for igual ao url do álbum.
subjectOf.potentialAction ListenAction Obrigatório para ações baseadas em entidades: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as propriedades de marcação de ação para mais detalhes.
image ImageObject Imagem que representa o MusicAlbum. Consulte Propriedades de marcação de imagem.
sameAs URL Um URL para 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 neste á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 a família (ou seja, adequado para todos os membros de uma família, incluindo crianças). Os produtos do Google podem usar o isFamilyFriendly ao 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 reproduzir para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros itens do seu catálogo. Portanto, a escala da pontuação precisa ser consistente em todos os seus feeds e entre todas as entidades do 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. Uma pontuação mais alta significa maior popularidade.
popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.

MusicRecording

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.googleapis.com", {"@language": "xx"}].
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem seja inglês.
@type Texto Obrigatório: sempre definido como MusicRecording para músicas/faixas.
@id URL Obrigatório: o identificador do conteúdo no formato URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em todo o catálogo
  • Estático. O ID precisa ser estável e não pode ser alterado ao longo do tempo, mesmo que a propriedade "url" do programa mude. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • Na forma de um identificador uniforme de recursos (URI)
  • O domínio usado para o valor @id precisa ser de propriedade da sua organização.
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url de 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 corresponder o conteúdo do seu feed com o conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico funcional que o Google possa rastrear.
  • url precisa apontar para uma página de descrição de conteúdo que não esteja bloqueada por um paywall.
Para o link direto de reprodução, consulte a propriedade urlTemplate do objeto target.
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 @id exclusivo usado para o 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 MusicGroup para essa propriedade.
byArtist.@id URL Obrigatório: o identificador do artista da música. Consulte os requisitos para @id acima. Ele precisa corresponder ao @id usado para o artista/grupo em outro lugar do 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 de marcação de ação para mais detalhes.
subjectOf MusicPlaylist Obrigatório para ações baseadas em entidades: detalhes da ação baseada em entidades
subjectOf.@type Texto Obrigatório para ações baseadas em entidades: sempre defina como MusicPlaylist para essa propriedade.
subjectOf.@id URL Obrigatório para ações baseadas em entidades: o identificador da ação baseada em entidades. Consulte os requisitos para @id acima. Ele precisa ser diferente do @id da música.
subjectOf.url URL Obrigatório para ações baseadas em entidades: o URL canônico da ação baseada em entidades. Consulte os requisitos para url acima. Você pode deixar isso de fora se for o mesmo que o url da música.
subjectOf.potentialAction ListenAction Obrigatório para ações baseadas em entidades: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as propriedades de marcação de ação para mais detalhes.
image ImageObject Imagem que representa o MusicRecording. Consulte Propriedades de marcação de imagem.
sameAs URL Um URL para 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 definido como MusicAlbum para essa propriedade.
inAlbum.@id URL O identificador do álbum. Consulte os requisitos para @id acima. Ele precisa corresponder ao @id usado 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 a família (ou seja, adequado para todos os membros de uma família, incluindo crianças). Os produtos do Google podem usar o isFamilyFriendly ao 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 reproduzir para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros itens do seu catálogo. Portanto, a escala da pontuação precisa ser consistente em todos os seus feeds e entre todas as entidades do 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. Uma pontuação mais alta significa maior popularidade.
popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.

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"
        }
      }
    }
  }
}

Confira as seguintes páginas para ver os tópicos relacionados a essas propriedades: