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

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 defina como ["http://schema.googleapis.com", {"@language": "xx"}].
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado 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 esteja em inglês.
@type Texto Obrigatório: sempre defina 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 no seu catálogo
  • Estático O ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade de URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link em funcionamento.
  • Na forma de URI (Identificador de recurso unificado)
  • O domínio usado para o valor @id precisa ser da sua organização.
Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela 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 ao 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 em funcionamento que possa ser rastreado pelo Google.
  • O url precisa direcionar para uma página de descrição do conteúdo que não seja bloqueada por um paywall.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto de destino.
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 de sugestão de entidade: detalhes da ação de sugestão de entidade.
subjectOf.@type Texto Obrigatório para ações de origem de entidade: sempre defina como MusicPlaylist para essa propriedade.
subjectOf.@id URL Obrigatório para ações de origem de entidade: é o identificador da ação de sugestão de entidade. Veja os requisitos para @id acima. Ele precisa ser diferente de @id para o artista/grupo.
subjectOf.url URL Obrigatório para ações de origem de entidades: é o URL canônico da ação sugerida pela entidade. Veja os requisitos para url acima. Você pode não incluir essa informação se for a mesma url do artista/grupo.
subjectOf.potentialAction ListenAction Obrigatório para ações de origem de 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 Um URL para uma página da Web de referência que possa identificar o artista. por exemplo, a página do artista na Wikipédia. Ela 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, é adequado para todos os membros de uma família, incluindo crianças. Os produtos do Google podem usar isFamilyFriendly ao 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 vai ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos do seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no 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 (EARTH)

MusicAlbum

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre defina como ["http://schema.googleapis.com", {"@language": "xx"}].
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado 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 esteja em inglês.
@type Texto Obrigatório: sempre defina 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 no seu catálogo
  • Estático O ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade de URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link em funcionamento.
  • Na forma de URI (Identificador de recurso unificado)
  • O domínio usado para o valor @id precisa ser da sua organização.
Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela 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 ao 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 em funcionamento que possa ser rastreado pelo Google.
  • O url precisa direcionar para uma página de descrição do conteúdo que não seja bloqueada por um paywall.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto de destino.
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, forneça uma matriz de valores em byArtist.
byArtist.@type Texto Obrigatório: sempre defina como MusicGroup para essa propriedade.
byArtist.@id URL Obrigatório: o identificador do artista do álbum. Veja os requisitos para @id acima. Ele precisa corresponder ao @id que você usa para o artista/grupo em outra parte 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 de sugestão de entidade: detalhes da ação de sugestão de entidade.
subjectOf.@type Texto Obrigatório para ações de origem de entidade: sempre defina como MusicPlaylist para essa propriedade.
subjectOf.@id URL Obrigatório para ações de origem de entidade: é o identificador da ação de sugestão de entidade. Veja os requisitos para @id acima. Ele precisa ser diferente de @id do álbum.
subjectOf.url URL Obrigatório para ações de origem de entidades: é o URL canônico da ação sugerida pela entidade. Veja os requisitos para url acima. Você pode deixar de fora se for igual ao url do álbum.
subjectOf.potentialAction ListenAction Obrigatório para ações de origem de 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 possa identificar o álbum; por exemplo, a página do álbum na Wikipédia. Ela precisa ser diferente da propriedade url.
numTracks Número inteiro O número de músicas ou faixas neste álbum.
timeRequired Texto É o tamanho 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, é adequado para todos os membros de uma família, incluindo crianças. Os produtos do Google podem usar 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 vai ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos do seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no 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 defina como ["http://schema.googleapis.com", {"@language": "xx"}].
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado 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 esteja em inglês.
@type Texto Obrigatório: sempre defina 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 no seu catálogo
  • Estático O ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade de URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link em funcionamento.
  • Na forma de URI (Identificador de recurso unificado)
  • O domínio usado para o valor @id precisa ser da sua organização.
Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela 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 ao 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 em funcionamento que possa ser rastreado pelo Google.
  • O url precisa direcionar para uma página de descrição do conteúdo que não seja bloqueada por um paywall.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto de destino.
name Texto Obrigatório: o nome da música.
byArtist MusicGroup Obrigatório: o artista ou o 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, você poderá fornecer uma matriz de valores em byArtist.
byArtist.@type Texto Obrigatório: sempre defina como MusicGroup para essa propriedade.
byArtist.@id URL Obrigatório: o identificador do artista da música. Veja os requisitos para @id acima. Ele precisa corresponder ao @id que você usa para o artista/grupo em outra parte 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 de sugestão de entidade: detalhes da ação de sugestão de entidade.
subjectOf.@type Texto Obrigatório para ações de origem de entidade: sempre defina como MusicPlaylist para essa propriedade.
subjectOf.@id URL Obrigatório para ações de origem de entidade: é o identificador da ação de sugestão de entidade. Veja os requisitos para @id acima. Ele precisa ser diferente do @id da música.
subjectOf.url URL Obrigatório para ações de origem de entidades: é o URL canônico da ação sugerida pela entidade. Veja os requisitos para url acima. Você pode deixar de fora se for o mesmo que o url da música.
subjectOf.potentialAction ListenAction Obrigatório para ações de origem de 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 possa identificar o álbum; por exemplo, a página do álbum na Wikipédia. Ela precisa ser diferente da propriedade url.
inAlbum MusicAlbum O álbum em que a faixa aparece, se houver.
inAlbum.@type Texto Sempre defina como MusicAlbum para esta propriedade.
inAlbum.@id URL O identificador do álbum. Veja os requisitos para @id acima. Ele precisa corresponder ao @id que você usa para o álbum em outros lugares 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, é adequado para todos os membros de uma família, incluindo crianças. Os produtos do Google podem usar 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 vai ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos do seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no 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 páginas a seguir para os tópicos relacionados a essas propriedades: