Spotify (Editor Independente) (Versão prévia)
O conector do Spotify lhe dará acesso à biblioteca, artistas, álbuns, faixas e muito mais!
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Daniel Laskewitz |
| URL | https://youtube.com/daniellaskewitz |
| connectorsupport@laskewitz.io |
| Metadados do conector | |
|---|---|
| Publicador | Daniel Laskewitz |
| Site | https://spotify.com |
| Política de privacidade | https://www.spotify.com/us/legal/privacy-policy/ |
| Categorias | Estilo de vida e entretenimento; Mídias Sociais |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Obter o perfil do usuário atual |
Obtenha informações detalhadas do perfil sobre o usuário atual (incluindo o nome de usuário do usuário atual). |
| Obter os principais artistas de um usuário |
Obtenha os principais artistas do usuário atual com base na afinidade calculada. |
| Obter todas as novas versões |
Uma lista de lançamentos de novos álbuns em destaque no Spotify (exemplo: guia 'Procurar' no player do Spotify). |
| Obter álbuns salvos do usuário |
Obtenha uma lista dos álbuns salvos na biblioteca "Sua Música" do usuário atual do Spotify. |
Obter o perfil do usuário atual
Obtenha informações detalhadas do perfil sobre o usuário atual (incluindo o nome de usuário do usuário atual).
Retornos
Informações privadas do usuário.
- Usuário Privado
- PrivateUser
Obter os principais artistas de um usuário
Obtenha os principais artistas do usuário atual com base na afinidade calculada.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
items
|
items | array of Artist |
Os principais artistas do usuário atual. |
|
Href
|
href | string |
Um link para o ponto de extremidade da API Web retornando o resultado completo da solicitação |
|
Limit
|
limit | integer |
O número máximo de itens na resposta (conforme definido na consulta ou por padrão). |
|
Next
|
next | string |
URL para a próxima página de itens. (nulo se nenhum) |
|
Offset
|
offset | integer |
O deslocamento dos itens retornados (conforme definido na consulta ou por padrão) |
|
Anterior
|
previous | string |
URL para a página anterior de itens. (nulo se nenhum) |
|
Total
|
total | integer |
O número total de itens disponíveis para retornar. |
Obter todas as novas versões
Uma lista de lançamentos de novos álbuns em destaque no Spotify (exemplo: guia 'Procurar' no player do Spotify).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
País
|
country | string |
Forneça esse parâmetro se você quiser que a lista de itens retornados seja relevante para um determinado país. Se omitidos, os itens retornados serão relevantes para todos os países. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Álbuns
|
albums.items | array of SimplifiedAlbum |
Uma lista de lançamentos de novos álbuns em destaque no Spotify. |
Obter álbuns salvos do usuário
Obtenha uma lista dos álbuns salvos na biblioteca "Sua Música" do usuário atual do Spotify.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Álbuns
|
items | array of Album |
Obtenha uma lista dos álbuns salvos na biblioteca "Sua Música" do usuário atual do Spotify. |
|
Href
|
href | string |
Um link para o ponto de extremidade da API Web retornando o resultado completo da solicitação |
|
Limit
|
limit | integer |
O número máximo de itens na resposta (conforme definido na consulta ou por padrão). |
|
Next
|
next | string |
URL para a próxima página de itens. (nulo se nenhum) |
|
Offset
|
offset | integer |
O deslocamento dos itens retornados (conforme definido na consulta ou por padrão) |
|
Anterior
|
previous | string |
URL para a página anterior de itens. (nulo se nenhum) |
|
Total
|
total | integer |
O número total de itens disponíveis para retornar. |
Definições
Álbum
álbum
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tipo de álbum
|
album_type | string |
O tipo do álbum: álbum, single ou compilação. |
|
Artistas
|
artists | array of Artist |
Os artistas do álbum. Cada objeto de artista inclui um link no href para obter informações mais detalhadas sobre o artista. |
|
Mercados disponíveis
|
available_markets | array of string |
Os mercados nos quais o álbum está disponível: códigos de país alfa-2 ISO 3166-1. |
|
Direitos autorais
|
copyrights | array of Copyright |
As declarações de direitos autorais do álbum. |
|
IDs externas
|
external_ids | ExternalId |
IDs externas conhecidas para o álbum. |
|
URLs externas
|
external_urls | ExternalUrl |
URLs externas conhecidas para este objeto. |
|
Gêneros
|
genres | array of |
Uma lista dos gêneros usados para classificar o álbum. Por exemplo: 'Prog Rock' , 'Post-Grunge'. (Se ainda não estiver classificada, a matriz estará vazia.) |
|
Href
|
href | string |
Um link para o ponto de extremidade da API Web fornecendo detalhes completos do álbum. |
|
ID
|
id | string |
A ID do Spotify para o álbum. |
|
Imagens
|
images | array of Image |
A capa do álbum em vários tamanhos, a mais larga primeiro. |
|
Etiqueta
|
label | string |
A gravadora do álbum. |
|
Nome
|
name | string |
O nome do álbum. No caso de uma queda de álbum, o valor pode ser uma cadeia de caracteres vazia. |
|
Popularidade
|
popularity | integer |
A popularidade do álbum. O valor será entre 0 e 100, sendo 100 o mais popular. A popularidade é calculada com base na popularidade das faixas individuais do álbum. |
|
Data de lançamento
|
release_date | string |
A data em que o álbum foi lançado pela primeira vez, por exemplo, '1981-12-15'. Dependendo da precisão, ela pode ser mostrada como '1981' ou '1981-12'. |
|
Precisão da data de lançamento
|
release_date_precision | string |
A precisão com a qual release_date valor é conhecido: 'ano', 'mês' ou 'dia'. |
|
Restrições
|
restrictions | AlbumRestriction | |
|
Total de faixas
|
total_tracks | integer |
O número total de faixas no álbum. |
|
Faixas
|
tracks | array of SimplifiedTrack |
As faixas do álbum. |
|
Tipo
|
type | string |
O tipo de objeto: 'album' |
|
URI
|
uri | string |
O URI do Spotify para o álbum. |
AlbumRestriction
Artista
O(s) artista(s) performático(s).
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
URLs externas
|
external_urls | ExternalUrl |
URLs externas conhecidas para este objeto. |
|
Href
|
href | string |
Um link para o ponto de extremidade da API Web fornecendo detalhes completos do artista. |
|
ID
|
id | string |
A ID do Spotify para o artista. |
|
Nome
|
name | string |
O nome do artista. |
|
Tipo
|
type | string |
O tipo de objeto: 'artist' |
|
URI
|
uri | string |
O URI do Spotify para o artista. |
Direitos autorais
As instruções de direitos autorais.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto
|
text | string |
O texto de direitos autorais para este conteúdo. |
|
Tipo
|
type | string |
O tipo de direitos autorais: C = os direitos autorais, P = a gravação de som (desempenho) direitos autorais. |
ExplicitContentSettings
As configurações de conteúdo explícitas do usuário.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Filtro Habilitado
|
filter_enabled | boolean |
Quando verdadeiro, indica que o conteúdo explícito não deve ser reproduzido. |
|
Filtro Bloqueado
|
filter_locked | boolean |
Quando true, indica que a configuração de conteúdo explícito está bloqueada e não pode ser alterada pelo usuário. |
ExternalId
IDs externas conhecidas para o álbum.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
EAN
|
ean | string |
Número do Artigo Internacional. |
|
ISRC
|
isrc | string |
Código de gravação padrão internacional. |
|
UPC
|
upc | string |
Código universal do produto. |
ExternalUrl
URLs externas conhecidas para este objeto.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Spotify
|
spotify | string |
A URL do Spotify para o objeto. |
Seguidores
Informações sobre os seguidores.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
href
|
href | string |
href |
|
total
|
total | integer |
total |
Imagem
Imagem pertencente ao objeto.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
height
|
height | integer |
height |
|
url
|
url | string |
url |
|
largura
|
width | integer |
largura |
LinkedTrack
PrivateUser
Informações privadas do usuário.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
País
|
country | string |
O país do usuário, conforme definido no perfil da conta do usuário. |
|
Nome de Exibição
|
display_name | string |
O nome exibido no perfil do usuário. |
|
Email
|
string |
O endereço de email do usuário. |
|
|
Configurações de conteúdo explícitas
|
explicit_content | ExplicitContentSettings |
As configurações de conteúdo explícitas do usuário. |
|
URLs externas
|
external_urls | ExternalUrl |
URLs externas conhecidas para este objeto. |
|
Seguidores
|
followers | Followers |
Informações sobre os seguidores. |
|
Href
|
href | string |
Um link para o ponto de extremidade da API Web para esse usuário. |
|
ID
|
id | string |
A ID do Spotify para o usuário. |
|
Imagem
|
images | Image |
Imagem pertencente ao objeto. |
|
Product
|
product | string |
O nível de assinatura do Spotify do usuário: 'premium', 'gratuito', etc. (O nível de assinatura 'open' pode ser considerado o mesmo que 'gratuito'.) |
|
Tipo
|
type | string |
O tipo de objeto: 'user' |
|
URI
|
uri | string |
O URI do Spotify para o usuário. |
SimplifiedAlbum
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Grupo de Álbuns
|
album_group | string |
O campo está presente ao obter álbuns de um artista. Os valores possíveis são 'album', 'single', 'compilation', 'appears_on'. Compare com album_type esse campo representa a relação entre o artista e o álbum. |
|
Tipo de álbum
|
album_type | string |
O tipo do álbum: um de 'album', 'single' ou 'compilation'. |
|
Artistas
|
artists | array of SimplifiedArtist |
Os artistas do álbum. Cada objeto de artista inclui um link no href para obter informações mais detalhadas sobre o artista. |
|
Mercados Disponíveis
|
available_markets | array of string |
Os mercados nos quais o álbum está disponível: códigos de país alfa-2 ISO 3166-1. |
|
URLs externas
|
external_urls | ExternalUrl |
URLs externas conhecidas para este objeto. |
|
Href
|
href | string |
Um link para o ponto de extremidade da API Web fornecendo detalhes completos do álbum. |
|
ID
|
id | string |
A ID do Spotify para o álbum. |
|
Imagens
|
images | array of Image |
A capa do álbum em vários tamanhos, a mais larga primeiro. |
|
Nome
|
name | string |
O nome do álbum. No caso de uma queda de álbum, o valor pode ser uma cadeia de caracteres vazia. |
|
Tipo
|
type | string |
O tipo de objeto: 'album' |
|
URI
|
uri | string |
O URI do Spotify para o álbum. |
SimplifiedArtist
O(s) artista(s) performático(s).
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
URLs externas
|
external_urls | ExternalUrl |
URLs externas conhecidas para este objeto. |
|
Href
|
href | string |
Um link para o ponto de extremidade da API Web fornecendo detalhes completos do artista. |
|
ID
|
id | string |
A ID do Spotify para o artista. |
|
Nome
|
name | string |
O nome do artista. |
|
Tipo
|
type | string |
O tipo de objeto: 'artist' |
|
URI
|
uri | string |
O URI do Spotify para o artista. |
SimplifiedTrack
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Artistas
|
artists | array of SimplifiedArtist |
Os artistas que tocaram a faixa. |
|
Mercados Disponíveis
|
available_markets | array of string |
Uma lista dos países em que a faixa pode ser reproduzida, identificada pelo código ISO 3166-1 alfa-2. |
|
Número do disco
|
disc_number | integer |
O número do disco (geralmente 1, a menos que o álbum consista em mais de um disco). |
|
Duração (ms)
|
duration_ms | integer |
O comprimento da faixa em milissegundos. |
|
Explicit
|
explicit | boolean |
Se a faixa tem ou não letras explícitas (true = sim faz; false = não, ela não ou desconhecida). |
|
URLs externas
|
external_urls | ExternalUrl |
URLs externas conhecidas para este objeto. |
|
Href
|
href | string |
Um link para o ponto de extremidade da API Web fornecendo detalhes completos da faixa. |
|
ID
|
id | string |
A ID do Spotify para a faixa. |
|
É Local
|
is_local | boolean |
Se a faixa é ou não de um arquivo local. |
|
É reproduzível
|
is_playable | boolean |
Parte da resposta quando a relinking de faixa é aplicada. Se for true, a faixa será reproduzida no mercado determinado. Caso contrário, false. |
|
linked_from
|
linked_from | LinkedTrack | |
|
Nome
|
name | string |
O nome da faixa. |
|
URL de visualização
|
preview_url | string |
Uma URL para uma versão prévia de 30 segundos (formato MP3) da faixa. |
|
Restrições
|
restrictions | TrackRestriction |
O motivo da restrição. |
|
Rastrear Número
|
track_number | integer |
O número da faixa. Se um álbum tiver vários discos, o número da faixa será o número do disco especificado. |
|
Tipo
|
type | string |
O tipo de objeto: 'track'. |
|
URI
|
uri | string |
O URI do Spotify para a faixa. |