Udostępnij przez


Spotify (niezależny wydawca) (wersja zapoznawcza)

Łącznik Spotify zapewni Ci dostęp do biblioteki, artystów, albumów, utworów i nie tylko!

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Daniel Laskewitz
adres URL https://youtube.com/daniellaskewitz
Email connectorsupport@laskewitz.io
Metadane łącznika
Publisher Daniel Laskewitz
Witryna internetowa https://spotify.com
Zasady ochrony prywatności https://www.spotify.com/us/legal/privacy-policy/
Kategorie Styl życia i rozrywka; Media społecznościowe

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Pobieranie najlepszych artystów użytkownika

Pobierz najlepszych artystów bieżącego użytkownika na podstawie obliczonej koligacji.

Pobieranie zapisanych albumów użytkownika

Pobierz listę albumów zapisanych w bibliotece "Your Music" bieżącego użytkownika Spotify.

Pobierz wszystkie nowe wersje

Lista nowych wydań albumów polecanych w Spotify (przykład: "Przeglądaj" na odtwarzaczu Spotify).

Uzyskiwanie profilu bieżącego użytkownika

Uzyskaj szczegółowe informacje o profilu bieżącego użytkownika (w tym nazwę użytkownika bieżącego użytkownika).

Pobieranie najlepszych artystów użytkownika

Pobierz najlepszych artystów bieżącego użytkownika na podstawie obliczonej koligacji.

Zwraca

Nazwa Ścieżka Typ Opis
items
items array of Artist

Najlepsi artyści bieżącego użytkownika.

Href
href string

Link do punktu końcowego internetowego interfejsu API zwracający pełny wynik żądania

Ograniczenie
limit integer

Maksymalna liczba elementów w odpowiedzi (ustawiona w zapytaniu lub domyślnie).

Next
next string

Adres URL do następnej strony elementów. (null, jeśli nie)

Przesunięcie
offset integer

Przesunięcie zwracanych elementów (zgodnie z ustawieniem w zapytaniu lub domyślnie)

Wstecz
previous string

Adres URL poprzedniej strony elementów. (null, jeśli nie)

Total
total integer

Całkowita liczba dostępnych elementów do zwrócenia.

Pobieranie zapisanych albumów użytkownika

Pobierz listę albumów zapisanych w bibliotece "Your Music" bieżącego użytkownika Spotify.

Zwraca

Nazwa Ścieżka Typ Opis
Albumy
items array of Album

Pobierz listę albumów zapisanych w bibliotece "Your Music" bieżącego użytkownika Spotify.

Href
href string

Link do punktu końcowego internetowego interfejsu API zwracający pełny wynik żądania

Ograniczenie
limit integer

Maksymalna liczba elementów w odpowiedzi (ustawiona w zapytaniu lub domyślnie).

Next
next string

Adres URL do następnej strony elementów. (null, jeśli nie)

Przesunięcie
offset integer

Przesunięcie zwracanych elementów (zgodnie z ustawieniem w zapytaniu lub domyślnie)

Wstecz
previous string

Adres URL poprzedniej strony elementów. (null, jeśli nie)

Total
total integer

Całkowita liczba dostępnych elementów do zwrócenia.

Pobierz wszystkie nowe wersje

Lista nowych wydań albumów polecanych w Spotify (przykład: "Przeglądaj" na odtwarzaczu Spotify).

Parametry

Nazwa Klucz Wymagane Typ Opis
Country
country string

Podaj ten parametr, jeśli chcesz, aby lista zwróconych elementów był odpowiednia dla określonego kraju. W przypadku pominięcia zwrócone elementy będą istotne dla wszystkich krajów.

Zwraca

Nazwa Ścieżka Typ Opis
Albumy
albums.items array of SimplifiedAlbum

Lista nowych wydań albumów polecanych w Spotify.

Uzyskiwanie profilu bieżącego użytkownika

Uzyskaj szczegółowe informacje o profilu bieżącego użytkownika (w tym nazwę użytkownika bieżącego użytkownika).

Zwraca

Prywatne informacje o użytkowniku.

Użytkownik prywatny
PrivateUser

Definicje

Album

album

Nazwa Ścieżka Typ Opis
Typ albumu
album_type string

Typ albumu: album, singiel lub kompilacja.

Artystów
artists array of Artist

Artyści albumu. Każdy obiekt artysty zawiera link w href, aby uzyskać bardziej szczegółowe informacje na temat artysty.

Dostępne rynki
available_markets array of string

Rynki, na których jest dostępny album: ISO 3166-1 alfa-2 kody krajów.

Prawa autorskie
copyrights array of Copyright

Oświadczenia o prawach autorskich albumu.

Identyfikatory zewnętrzne
external_ids ExternalId

Znane zewnętrzne identyfikatory albumu.

Zewnętrzne adresy URL
external_urls ExternalUrl

Znane zewnętrzne adresy URL dla tego obiektu.

Gatunków
genres array of

Lista gatunków używanych do klasyfikowania albumu. Na przykład: "Prog Rock" , "Post-Grunge". (Jeśli jeszcze nie sklasyfikowano, tablica jest pusta).

Href
href string

Link do punktu końcowego internetowego interfejsu API z pełnymi szczegółami albumu.

Id
id string

Spotify ID dla albumu.

Obrazy
images array of Image

Grafika okładkowa albumu w różnych rozmiarach, najszersza pierwsza.

Etykieta
label string

Etykieta albumu.

Name
name string

Nazwa albumu. W przypadku przejęcia albumu wartość może być pustym ciągiem.

Popularność
popularity integer

Popularność albumu. Wartość będzie należeć do zakresu od 0 do 100, a 100 jest najpopularniejszą wartością. Popularność jest obliczana na podstawie popularności poszczególnych utworów albumu.

Data wydania
release_date string

Data wydania albumu, na przykład "1981-12-15". W zależności od dokładności może być wyświetlany jako "1981" lub "1981-12".

Precyzja daty wydania
release_date_precision string

Precyzja, z jaką release_date wartość jest znana: "rok", "miesiąc" lub "dzień".

Ograniczenia
restrictions AlbumRestriction
Łączna liczba ścieżek
total_tracks integer

Całkowita liczba utworów w albumie.

Utworów
tracks array of SimplifiedTrack

Utwory albumu.

Typ
type string

Typ obiektu: "album"

URI
uri string

Identyfikator URI Spotify dla albumu.

AlbumRestriction

Artysta

Wykonawcy.

Nazwa Ścieżka Typ Opis
Zewnętrzne adresy URL
external_urls ExternalUrl

Znane zewnętrzne adresy URL dla tego obiektu.

Href
href string

Link do punktu końcowego internetowego interfejsu API z pełnymi szczegółami artysty.

Id
id string

Identyfikator Spotify dla artysty.

Name
name string

Nazwa artysty.

Typ
type string

Typ obiektu: "artysta"

URI
uri string

Identyfikator URI Spotify dla artysty.

Prawo autorskie

Oświadczenia o prawach autorskich.

Nazwa Ścieżka Typ Opis
Tekst
text string

Tekst prawa autorskiego do tej zawartości.

Typ
type string

Typ praw autorskich: C = prawa autorskie, P = prawa autorskie do nagrywania dźwięku (wydajność).

ExplicitContentSettings

Jawne ustawienia zawartości użytkownika.

Nazwa Ścieżka Typ Opis
Włączono filtrowanie
filter_enabled boolean

Jeśli wartość true, wskazuje, że jawna zawartość nie powinna być odtwarzana.

Filtr zablokowany
filter_locked boolean

Jeśli wartość true, wskazuje, że jawne ustawienie zawartości jest zablokowane i nie można go zmienić przez użytkownika.

ExternalId

Znane zewnętrzne identyfikatory albumu.

Nazwa Ścieżka Typ Opis
EAN
ean string

Numer artykułu międzynarodowego.

ISRC
isrc string

Międzynarodowy standardowy kod nagrywania.

UPC
upc string

Kod produktu uniwersalnego.

ExternalUrl

Znane zewnętrzne adresy URL dla tego obiektu.

Nazwa Ścieżka Typ Opis
Spotify
spotify string

Adres URL Spotify dla obiektu.

Followers

Informacje o obserwatorach.

Nazwa Ścieżka Typ Opis
href
href string

href

łączny
total integer

łączny

obraz

Obraz należący do obiektu.

Nazwa Ścieżka Typ Opis
height
height integer

height

URL
url string

URL

width
width integer

width

LinkedTrack

PrivateUser

Prywatne informacje o użytkowniku.

Nazwa Ścieżka Typ Opis
Country
country string

Kraj użytkownika, zgodnie z ustawieniem w profilu konta użytkownika.

Wyświetlana nazwa
display_name string

Nazwa wyświetlana w profilu użytkownika.

Email
email string

Adres e-mail użytkownika.

Jawne ustawienia zawartości
explicit_content ExplicitContentSettings

Jawne ustawienia zawartości użytkownika.

Zewnętrzne adresy URL
external_urls ExternalUrl

Znane zewnętrzne adresy URL dla tego obiektu.

Followers
followers Followers

Informacje o obserwatorach.

Href
href string

Link do punktu końcowego internetowego interfejsu API dla tego użytkownika.

Id
id string

Identyfikator Spotify dla użytkownika.

obraz
images Image

Obraz należący do obiektu.

Product
product string

Poziom subskrypcji Spotify użytkownika: "premium", "bezpłatna" itp. (poziom subskrypcji "otwarty" może być uznawany za taki sam jak "bezpłatny").

Typ
type string

Typ obiektu: "użytkownik"

URI
uri string

Identyfikator URI Spotify dla użytkownika.

Uproszczony moduł równoważenia obciążenia

Nazwa Ścieżka Typ Opis
Grupa albumów
album_group string

Pole jest obecne podczas uzyskiwania albumów artysty. Możliwe wartości to "album", "single", "kompilacja", "appears_on". Porównaj z album_type to pole reprezentuje relację między artystą a albumem.

Typ albumu
album_type string

Typ albumu: jeden z "albumów", "single" lub "kompilacja".

Artystów
artists array of SimplifiedArtist

Artyści albumu. Każdy obiekt artysty zawiera link w href, aby uzyskać bardziej szczegółowe informacje na temat artysty.

Dostępne rynki
available_markets array of string

Rynki, na których jest dostępny album: ISO 3166-1 alfa-2 kody krajów.

Zewnętrzne adresy URL
external_urls ExternalUrl

Znane zewnętrzne adresy URL dla tego obiektu.

Href
href string

Link do punktu końcowego internetowego interfejsu API z pełnymi szczegółami albumu.

identyfikator
id string

Spotify ID dla albumu.

Obrazy
images array of Image

Grafika okładkowa albumu w różnych rozmiarach, najszersza pierwsza.

Name
name string

Nazwa albumu. W przypadku przejęcia albumu wartość może być pustym ciągiem.

Typ
type string

Typ obiektu: "album"

URI
uri string

Identyfikator URI Spotify dla albumu.

SimplifiedArtist

Wykonawcy.

Nazwa Ścieżka Typ Opis
Zewnętrzne adresy URL
external_urls ExternalUrl

Znane zewnętrzne adresy URL dla tego obiektu.

Href
href string

Link do punktu końcowego internetowego interfejsu API z pełnymi szczegółami artysty.

Id
id string

Identyfikator Spotify dla artysty.

Name
name string

Nazwa artysty.

Typ
type string

Typ obiektu: "artysta"

URI
uri string

Identyfikator URI Spotify dla artysty.

Uproszczone śledzenie

Nazwa Ścieżka Typ Opis
Artystów
artists array of SimplifiedArtist

Artyści, którzy wykonali utwór.

Dostępne rynki
available_markets array of string

Lista krajów, w których można odtworzyć tor, zidentyfikowany przez kod ISO 3166-1 alfa-2.

Numer dysku
disc_number integer

Numer dysku (zwykle 1, chyba że album składa się z więcej niż jednego dysku).

Czas trwania (ms)
duration_ms integer

Długość toru w milisekundach.

Wyraźny
explicit boolean

Niezależnie od tego, czy utwór ma jawne teksty (prawda = tak, nie; false = nie, nie lub nieznany).

Zewnętrzne adresy URL
external_urls ExternalUrl

Znane zewnętrzne adresy URL dla tego obiektu.

Href
href string

Link do punktu końcowego internetowego interfejsu API z pełnymi szczegółami ścieżki.

identyfikator
id string

Spotify ID dla utworu.

Jest lokalny
is_local boolean

Określa, czy utwór pochodzi z pliku lokalnego.

Jest odtwarzany
is_playable boolean

Część odpowiedzi podczas śledzenia ponownego łączenia jest stosowana. Jeśli to prawda, utwór można odtworzyć na danym rynku. W przeciwnym razie wartość false.

linked_from
linked_from LinkedTrack
Name
name string

Nazwa toru.

Adres URL podglądu
preview_url string

Adres URL do 30-sekundowej wersji zapoznawczej (format MP3) ścieżki.

Ograniczenia
restrictions TrackRestriction

Przyczyna ograniczenia.

Śledzenie numeru
track_number integer

Liczba utworów. Jeśli album ma kilka płyt, numer utworu jest liczbą na określonym dysku.

Typ
type string

Typ obiektu: "track".

URI
uri string

Identyfikator URI Spotify dla utworu.

TrackRestriction

Przyczyna ograniczenia.

Przyczyna ograniczenia.