Spotify (獨立發行商) (預覽版)
Spotify 連接器將使您能夠訪問您的音樂庫、藝術家、專輯、曲目等!
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | 丹尼爾·拉斯克維茨 |
| URL | https://youtube.com/daniellaskewitz |
| connectorsupport@laskewitz.io |
| 連接器中繼資料 | |
|---|---|
| Publisher | 丹尼爾·拉斯克維茨 |
| 網站 | https://spotify.com |
| 隱私策略 | https://www.spotify.com/us/legal/privacy-policy/ |
| 類別 | 生活方式和娛樂;社交媒體 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 獲取所有新版本 |
Spotify 中精選的新專輯列表(例如:Spotify 播放器上的“瀏覽”選項卡)。 |
| 獲取用戶保存的相冊 |
獲取保存在當前 Spotify 用戶的“您的音樂”庫中的專輯列表。 |
| 獲取用戶的頂級藝術家 |
根據計算的親和力獲取當前用戶的頂級藝術家。 |
| 獲取當前用戶的個人資料 |
獲取有關當前用戶的詳細個人資料信息(包括當前用戶的用戶名)。 |
獲取所有新版本
Spotify 中精選的新專輯列表(例如:Spotify 播放器上的“瀏覽”選項卡)。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
國家
|
country | string |
如果您希望傳回的項目清單與特定國家/地區相關,請提供此參數。 如果省略,退回的商品將與所有國家/地區相關。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專輯
|
albums.items | array of SimplifiedAlbum |
Spotify 中推出的新專輯列表。 |
獲取用戶保存的相冊
獲取保存在當前 Spotify 用戶的“您的音樂”庫中的專輯列表。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專輯
|
items | array of Album |
獲取保存在當前 Spotify 用戶的“您的音樂”庫中的專輯列表。 |
|
赫雷夫
|
href | string |
傳回要求完整結果之 Web API 端點的連結 |
|
限制
|
limit | integer |
回應中的項目數目上限 (如查詢中設定或預設設定)。 |
|
Next
|
next | string |
項目下一頁的 URL。 (如果沒有,則為空值) |
|
Offset
|
offset | integer |
傳回項目的位移量 (如查詢中設定或預設) |
|
上一個
|
previous | string |
項目上一頁的 URL。 (如果沒有,則為空值) |
|
總數
|
total | integer |
可退貨的項目總數。 |
獲取用戶的頂級藝術家
根據計算的親和力獲取當前用戶的頂級藝術家。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
items
|
items | array of Artist |
當前用戶的頂級藝術家。 |
|
赫雷夫
|
href | string |
傳回要求完整結果之 Web API 端點的連結 |
|
限制
|
limit | integer |
回應中的項目數目上限 (如查詢中設定或預設設定)。 |
|
Next
|
next | string |
項目下一頁的 URL。 (如果沒有,則為空值) |
|
Offset
|
offset | integer |
傳回項目的位移量 (如查詢中設定或預設) |
|
上一個
|
previous | string |
項目上一頁的 URL。 (如果沒有,則為空值) |
|
總數
|
total | integer |
可退貨的項目總數。 |
獲取當前用戶的個人資料
定義
影集
簽名簿
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
相簿類型
|
album_type | string |
專輯類型:專輯、單曲或合輯。 |
|
藝術家
|
artists | array of Artist |
專輯的藝術家。 每個藝術家物件都在 href 中包含一個連結,指向有關藝術家的更多詳細資訊。 |
|
可用市場
|
available_markets | array of string |
專輯可用的市場:ISO 3166-1 alpha-2 國家代碼。 |
|
版權
|
copyrights | array of Copyright |
專輯的版權聲明。 |
|
外部 ID
|
external_ids | ExternalId |
相簿的已知外部 ID。 |
|
外部網址
|
external_urls | ExternalUrl |
此物件的已知外部 URL。 |
|
遊戲類型
|
genres | array of |
用於對專輯進行分類的流派列表。 例如:“前衛搖滾”、“後垃圾搖滾”。 (如果尚未分類,則陣列是空的。 |
|
赫雷夫
|
href | string |
Web API 端點的連結,提供相簿的完整詳細資料。 |
|
Id
|
id | string |
專輯的 Spotify ID。 |
|
圖片
|
images | array of Image |
專輯的封面藝術有各種尺寸,最寬的在前。 |
|
標籤
|
label | string |
專輯的標籤。 |
|
名稱
|
name | string |
專輯的名稱。 如果專輯刪除,則值可能是空字串。 |
|
人氣
|
popularity | integer |
專輯的受歡迎程度。 值介於 0 到 100 之間,其中 100 是最受歡迎的。 受歡迎程度是根據專輯中各個曲目的受歡迎程度計算的。 |
|
發行日期
|
release_date | string |
專輯首次發行的日期,例如“1981-12-15”。 根據精確度,它可能會顯示為「1981」或「1981-12」。 |
|
發布日期精度
|
release_date_precision | string |
已知release_date值的精確度:「年」、「月」或「日」。 |
|
限制
|
restrictions | AlbumRestriction | |
|
曲目總計
|
total_tracks | integer |
專輯中的曲目總數。 |
|
趾
|
tracks | array of SimplifiedTrack |
專輯的曲目。 |
|
類型
|
type | string |
物件類型:「album」 |
|
URI
|
uri | string |
專輯的 Spotify URI。 |
相簿限制
藝術家
表演藝術家。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
外部網址
|
external_urls | ExternalUrl |
此物件的已知外部 URL。 |
|
赫雷夫
|
href | string |
Web API端點的連結,提供藝術家的完整詳細資料。 |
|
Id
|
id | string |
藝術家的 Spotify ID。 |
|
名稱
|
name | string |
藝術家的姓名。 |
|
類型
|
type | string |
物件類型:「藝術家」 |
|
URI
|
uri | string |
藝術家的 Spotify URI。 |
著作權
版權聲明。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文字
|
text | string |
此內容的版權文本。 |
|
類型
|
type | string |
著作權類型:C=著作權,P=錄音(表演)著作權。 |
明確內容設定
使用者的明確內容設定。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
已啟用篩選器
|
filter_enabled | boolean |
如果為true,則表示不應播放露骨內容。 |
|
過濾器鎖定
|
filter_locked | boolean |
如果為 true,則表示明確內容設定已鎖定,且使用者無法變更。 |
外部標識
相簿的已知外部 ID。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
EAN的
|
ean | string |
國際商品編號。 |
|
ISRC
|
isrc | string |
國際標準錄音代碼。 |
|
UPC的
|
upc | string |
通用產品代碼。 |
外部網址
此物件的已知外部 URL。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Spotify
|
spotify | string |
物件的 Spotify URL。 |
Followers
有關追隨者的信息。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
href
|
href | string |
href |
|
總計
|
total | integer |
總計 |
影像
屬於物件的影像。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
height
|
height | integer |
height |
|
url
|
url | string |
url |
|
寬度
|
width | integer |
寬度 |
鏈接軌道
私人用戶
私人使用者資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
國家
|
country | string |
使用者的國家/地區,如使用者的帳戶設定檔中所設定。 |
|
顯示名稱
|
display_name | string |
使用者設定檔上顯示的名稱。 |
|
Email
|
string |
用戶的電子郵件位址。 |
|
|
露骨內容設定
|
explicit_content | ExplicitContentSettings |
使用者的明確內容設定。 |
|
外部網址
|
external_urls | ExternalUrl |
此物件的已知外部 URL。 |
|
Followers
|
followers | Followers |
有關追隨者的信息。 |
|
赫雷夫
|
href | string |
此使用者的 Web API 端點連結。 |
|
Id
|
id | string |
使用者的 Spotify ID。 |
|
影像
|
images | Image |
屬於物件的影像。 |
|
Product
|
product | string |
用戶的 Spotify 訂閱級別:“高級”、“免費”等(訂閱級別“開放”可以被視為與“免費”相同。 |
|
類型
|
type | string |
物件類型:「使用者」 |
|
URI
|
uri | string |
使用者的 Spotify URI。 |
簡化相簿
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專輯組
|
album_group | string |
獲取藝術家的專輯時,該字段就存在。 可能的值為 'album'、'single'、'compilation'、'appears_on'。 與album_type相比,此欄位代表藝術家與專輯之間的關係。 |
|
專輯類型
|
album_type | string |
專輯類型:“專輯”、“單曲”或“合輯”之一。 |
|
藝術家
|
artists | array of SimplifiedArtist |
專輯的藝術家。 每個藝術家物件都在 href 中包含一個連結,指向有關藝術家的更多詳細資訊。 |
|
可用市場
|
available_markets | array of string |
專輯可用的市場:ISO 3166-1 alpha-2 國家代碼。 |
|
外部網址
|
external_urls | ExternalUrl |
此物件的已知外部 URL。 |
|
赫雷夫
|
href | string |
Web API 端點的連結,提供相簿的完整詳細資料。 |
|
ID
|
id | string |
專輯的 Spotify ID。 |
|
圖片
|
images | array of Image |
專輯的封面藝術有各種尺寸,最寬的在前。 |
|
名稱
|
name | string |
專輯的名稱。 如果專輯刪除,則值可能是空字串。 |
|
類型
|
type | string |
物件類型:「album」 |
|
URI
|
uri | string |
專輯的 Spotify URI。 |
簡化藝術家
表演藝術家。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
外部網址
|
external_urls | ExternalUrl |
此物件的已知外部 URL。 |
|
赫雷夫
|
href | string |
Web API端點的連結,提供藝術家的完整詳細資料。 |
|
Id
|
id | string |
藝術家的 Spotify ID。 |
|
名稱
|
name | string |
藝術家的姓名。 |
|
類型
|
type | string |
物件類型:「藝術家」 |
|
URI
|
uri | string |
藝術家的 Spotify URI。 |
簡化軌道
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
藝術家
|
artists | array of SimplifiedArtist |
表演這首歌的藝術家。 |
|
可用市場
|
available_markets | array of string |
可以播放曲目的國家/地區列表,由其 ISO 3166-1 alpha-2 代碼標識。 |
|
光碟編號
|
disc_number | integer |
光碟編號 (通常為 1,除非專輯包含多張光碟)。 |
|
持續時間 (毫秒)
|
duration_ms | integer |
磁軌長度(以毫秒為單位)。 |
|
Explicit
|
explicit | boolean |
無論曲目是否有明確的歌詞(true = 是,它有;false = 否,它沒有或未知)。 |
|
外部網址
|
external_urls | ExternalUrl |
此物件的已知外部 URL。 |
|
赫雷夫
|
href | string |
Web API 端點的連結,提供追蹤的完整詳細資料。 |
|
ID
|
id | string |
曲目的 Spotify ID。 |
|
是本地的
|
is_local | boolean |
音軌是否來自本機檔案。 |
|
可玩
|
is_playable | boolean |
套用「追蹤重新連結」時的回應的一部分。 如果為 true,則該曲目可以在給定市場中播放。 否則為 false。 |
|
linked_from
|
linked_from | LinkedTrack | |
|
名稱
|
name | string |
軌道的名稱。 |
|
預覽 URL
|
preview_url | string |
曲目的 30 秒預覽 (MP3 格式) 的 URL。 |
|
限制
|
restrictions | TrackRestriction |
限制的原因。 |
|
軌道編號
|
track_number | integer |
軌道編號。如果專輯有多張光碟,則曲目編號是指定光碟上的編號。 |
|
類型
|
type | string |
物件類型:「track」。 |
|
URI
|
uri | string |
曲目的 Spotify URI。 |