Partilhar via


Spotify (Editora Independente) (Pré-visualização)

O conector Spotify dar-lhe-á acesso à sua Biblioteca, Artistas, Álbuns, Faixas e muito mais!

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - 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
Email connectorsupport@laskewitz.io
Metadados do conector
Editora Daniel Laskewitz
Sítio Web https://spotify.com
Política de privacidade https://www.spotify.com/us/legal/privacy-policy/
Categorias Estilo de Vida e Entretenimento; Redes Sociais

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Obtenha os melhores artistas de um usuário

Obtenha os principais artistas do usuário atual com base na afinidade calculada.

Obtenha todas as novas versões

Uma lista de lançamentos de novos álbuns apresentados no Spotify (Exemplo: separador 'Procurar' no leitor Spotify).

Obter perfil de usuário atual

Obtenha informações detalhadas do perfil sobre o usuário atual (incluindo o nome de usuário atual).

Obter álbuns salvos do usuário

Obtenha uma lista dos álbuns guardados na biblioteca "Your Music" do utilizador atual do Spotify.

Obtenha os melhores artistas de um usuário

Obtenha os principais artistas do usuário atual com base na afinidade calculada.

Devoluções

Name 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

Limite
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)

Compensação
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 devolução.

Obtenha todas as novas versões

Uma lista de lançamentos de novos álbuns apresentados no Spotify (Exemplo: separador 'Procurar' no leitor Spotify).

Parâmetros

Name Chave Necessário Tipo Description
Country
country string

Forneça este parâmetro se quiser que a lista de itens devolvidos seja relevante para um determinado país. Se omitidos, os itens devolvidos serão relevantes para todos os países.

Devoluções

Name Caminho Tipo Description
Álbuns
albums.items array of SimplifiedAlbum

Uma lista de lançamentos de novos álbuns apresentados no Spotify.

Obter perfil de usuário atual

Obtenha informações detalhadas do perfil sobre o usuário atual (incluindo o nome de usuário atual).

Devoluções

Informações privadas do utilizador.

Utilizador Privado
PrivateUser

Obter álbuns salvos do usuário

Obtenha uma lista dos álbuns guardados na biblioteca "Your Music" do utilizador atual do Spotify.

Devoluções

Name Caminho Tipo Description
Álbuns
items array of Album

Obtenha uma lista dos álbuns guardados na biblioteca "Your Music" do utilizador atual do Spotify.

Href
href string

Um link para o ponto de extremidade da API Web retornando o resultado completo da solicitação

Limite
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)

Compensação
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 devolução.

Definições

Álbum

álbum

Name 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 do artista inclui um link em href para informações mais detalhadas sobre o artista.

Mercados disponíveis
available_markets array of string

Os mercados em que o álbum está disponível: códigos de país ISO 3166-1 alpha-2.

Direitos de autor
copyrights array of Copyright

As declarações de direitos autorais do álbum.

IDs externos
external_ids ExternalId

IDs externos conhecidos 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 classificado, a matriz está vazia.)

Href
href string

Um link para o ponto de extremidade da API Web que fornece detalhes completos do álbum.

Id
id string

O ID do Spotify para o álbum.

Imagens
images array of Image

A arte da capa do álbum em vários tamanhos, mais larga primeiro.

Etiqueta
label string

A gravadora do álbum.

Nome
name string

O nome do álbum. No caso de uma retirada de álbum, o valor pode ser uma string vazia.

Popularidade
popularity integer

A popularidade do álbum. O valor será entre 0 e 100, sendo 100 o mais popular. A popularidade é calculada a partir da 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, pode ser apresentado como «1981» ou «1981-12».

Precisão da data de lançamento
release_date_precision string

A precisão com que release_date valor é conhecido: «ano», «mês» ou «dia».

Restrições
restrictions AlbumRestriction
Faixas Totais
total_tracks integer

O número total de faixas do álbum.

Faixas
tracks array of SimplifiedTrack

As faixas do álbum.

Tipo
type string

O tipo de objeto: 'álbum'

URI
uri string

O URI do Spotify para o álbum.

AlbumRestriction

Artista

O(s) artista(s) performativo(s).

Name 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 que fornece detalhes completos do artista.

Id
id string

O ID do Spotify para o artista.

Nome
name string

O nome do artista.

Tipo
type string

O tipo de objeto: 'artista'

URI
uri string

O URI do Spotify para o artista.

Direitos de autor

As declarações de direitos autorais.

Name Caminho Tipo Description
Texto
text string

O texto dos direitos autorais deste conteúdo.

Tipo
type string

O tipo de direito autoral: C = o direito autoral, P = o direito autoral de gravação de som (performance).

ExplicitContentSettings

As configurações de conteúdo explícito do usuário.

Name Caminho Tipo Description
Filtro ativado
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.

Identificação externa

IDs externos conhecidos para o álbum.

Name Caminho Tipo Description
EAN
ean string

Número internacional do artigo.

ISRC
isrc string

Código Internacional de Gravação Normalizado.

UPC
upc string

Código Universal do Produto.

Url Externa

URLs externas conhecidas para este objeto.

Name Caminho Tipo Description
Spotify [en]
spotify string

O URL do Spotify para o objeto.

Followers

Informações sobre os seguidores.

Name Caminho Tipo Description
HREF
href string

HREF

total
total integer

total

Imagem

Imagem pertencente ao objeto.

Name Caminho Tipo Description
altura
height integer

altura

URL
url string

URL

Largura
width integer

Largura

LinkedTrack

Utilizador Privado

Informações privadas do utilizador.

Name Caminho Tipo Description
Country
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
email string

O endereço de e-mail do usuário.

Configurações de conteúdo explícito
explicit_content ExplicitContentSettings

As configurações de conteúdo explícito do usuário.

urls externas
external_urls ExternalUrl

URLs externas conhecidas para este objeto.

Followers
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

O ID do Spotify para o utilizador.

Imagem
images Image

Imagem pertencente ao objeto.

Produto
product string

O nível de subscrição do Spotify do utilizador: 'premium', 'gratuito', etc. (O nível de subscrição 'aberto' pode ser considerado o mesmo que 'gratuito'.)

Tipo
type string

O tipo de objeto: 'usuário'

URI
uri string

O URI do Spotify para o usuário.

Álbum Simplificado

Name Caminho Tipo Description
Grupo de álbuns
album_group string

O campo está presente quando se obtém os álbuns de um artista. Os valores possíveis são 'álbum', 'single', 'compilação', 'appears_on'. Compare com album_type este campo representa a relação entre o artista e o álbum.

Tipo de álbum
album_type string

O tipo do álbum: um de 'álbum', 'single' ou 'compilação'.

Artistas
artists array of SimplifiedArtist

Os artistas do álbum. Cada objeto do artista inclui um link em href para informações mais detalhadas sobre o artista.

Mercados Disponíveis
available_markets array of string

Os mercados em que o álbum está disponível: códigos de país ISO 3166-1 alpha-2.

urls externas
external_urls ExternalUrl

URLs externas conhecidas para este objeto.

Href
href string

Um link para o ponto de extremidade da API Web que fornece detalhes completos do álbum.

ID
id string

O ID do Spotify para o álbum.

Imagens
images array of Image

A arte da capa do álbum em vários tamanhos, mais larga primeiro.

Nome
name string

O nome do álbum. No caso de uma retirada de álbum, o valor pode ser uma string vazia.

Tipo
type string

O tipo de objeto: 'álbum'

URI
uri string

O URI do Spotify para o álbum.

Artista Simplificado

O(s) artista(s) performativo(s).

Name 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 que fornece detalhes completos do artista.

Id
id string

O ID do Spotify para o artista.

Nome
name string

O nome do artista.

Tipo
type string

O tipo de objeto: 'artista'

URI
uri string

O URI do Spotify para o artista.

Pista Simplificada

Name Caminho Tipo Description
Artistas
artists array of SimplifiedArtist

Os artistas que interpretaram a faixa.

Mercados Disponíveis
available_markets array of string

Uma lista dos países em que a faixa pode ser reproduzida, identificados pelo seu código ISO 3166-1 alpha-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 pista em milissegundos.

Explícito
explicit boolean

Se a faixa tem ou não letra explícita (true = yes it does; false = não it does not OR unknown).

urls externas
external_urls ExternalUrl

URLs externas conhecidas para este objeto.

Href
href string

Um link para o ponto de extremidade da API Web que fornece detalhes completos da faixa.

ID
id string

O ID do Spotify para a faixa.

É local
is_local boolean

Se a faixa é ou não de um arquivo local.

É jogável
is_playable boolean

Parte da resposta quando a Revinculação de Faixas é aplicada. Se for verdadeira, a faixa é jogável no mercado em questão. Caso contrário, falso.

linked_from
linked_from LinkedTrack
Nome
name string

O nome da faixa.

URL de pré-visualização
preview_url string

Um URL para uma pré-visualização de 30 segundos (formato MP3) da faixa.

Restrições
restrictions TrackRestriction

O motivo da restrição.

Número da faixa
track_number integer

O número da faixa. Se um álbum tiver vários discos, o número da faixa é o número no disco especificado.

Tipo
type string

O tipo de objeto: 'track'.

URI
uri string

O URI do Spotify para a faixa.

TrackRestriction

O motivo da restrição.

O motivo da restrição.