Spotify (независимый издатель) (предварительная версия)
Соединитель Spotify предоставит вам доступ к библиотеке, артистам, альбомам, трекам и т. д.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Даниэль Ласкевиц |
| URL | https://youtube.com/daniellaskewitz |
| Адрес электронной почты | connectorsupport@laskewitz.io |
| Метаданные соединителя | |
|---|---|
| Publisher | Даниэль Ласкевиц |
| Website | https://spotify.com |
| Политика конфиденциальности | https://www.spotify.com/us/legal/privacy-policy/ |
| Категории | Образ жизни и развлечения; Социальные медиа |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Получение всех новых выпусков |
Список новых выпусков альбома, доступных в Spotify (пример: вкладка "Обзор" на проигрывателе Spotify). |
| Получение лучших художников пользователя |
Получение лучших художников текущего пользователя на основе вычисляемой сходства. |
| Получение профиля текущего пользователя |
Получите подробные сведения о текущем пользователе (включая имя пользователя текущего пользователя). |
| Получение сохраненных альбомов пользователя |
Получите список альбомов, сохраненных в текущей библиотеке Spotify пользователя "Ваша музыка". |
Получение всех новых выпусков
Список новых выпусков альбома, доступных в Spotify (пример: вкладка "Обзор" на проигрывателе Spotify).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Страна
|
country | string |
Укажите этот параметр, если требуется, чтобы список возвращаемых элементов был соответствующим для конкретной страны. Если опущено, возвращаемые элементы будут иметь отношение ко всем странам. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Альбомы
|
albums.items | array of SimplifiedAlbum |
Список новых выпусков альбома, доступных в Spotify. |
Получение лучших художников пользователя
Получение лучших художников текущего пользователя на основе вычисляемой сходства.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
items
|
items | array of Artist |
Лучшие художники текущего пользователя. |
|
Href
|
href | string |
Ссылка на конечную точку веб-API, возвращающую полный результат запроса |
|
Лимит
|
limit | integer |
Максимальное количество элементов в ответе (как указано в запросе или по умолчанию). |
|
Next
|
next | string |
URL-адрес следующей страницы элементов. (null, если нет) |
|
Смещение
|
offset | integer |
Смещение возвращаемых элементов (как задано в запросе или по умолчанию) |
|
Previous
|
previous | string |
URL-адрес предыдущей страницы элементов. (null, если нет) |
|
Total
|
total | integer |
Общее количество возвращаемых элементов. |
Получение профиля текущего пользователя
Получите подробные сведения о текущем пользователе (включая имя пользователя текущего пользователя).
Возвращаемое значение
Сведения о частном пользователе.
- Частный пользователь
- PrivateUser
Получение сохраненных альбомов пользователя
Получите список альбомов, сохраненных в текущей библиотеке Spotify пользователя "Ваша музыка".
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Альбомы
|
items | array of Album |
Получите список альбомов, сохраненных в текущей библиотеке Spotify пользователя "Ваша музыка". |
|
Href
|
href | string |
Ссылка на конечную точку веб-API, возвращающую полный результат запроса |
|
Лимит
|
limit | integer |
Максимальное количество элементов в ответе (как указано в запросе или по умолчанию). |
|
Next
|
next | string |
URL-адрес следующей страницы элементов. (null, если нет) |
|
Смещение
|
offset | integer |
Смещение возвращаемых элементов (как задано в запросе или по умолчанию) |
|
Previous
|
previous | string |
URL-адрес предыдущей страницы элементов. (null, если нет) |
|
Total
|
total | integer |
Общее количество возвращаемых элементов. |
Определения
Альбом
альбом
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Тип альбома
|
album_type | string |
Тип альбома: альбом, сингл или компиляция. |
|
Художников
|
artists | array of Artist |
Художники альбома. Каждый объект художника содержит ссылку в href, чтобы получить более подробную информацию о художнике. |
|
Доступные рынки
|
available_markets | array of string |
Рынки, в которых доступен альбом: коды стран ISO 3166-1 альфа-2. |
|
Авторские права
|
copyrights | array of Copyright |
Заявления об авторских правах альбома. |
|
Внешние идентификаторы
|
external_ids | ExternalId |
Известные внешние идентификаторы для альбома. |
|
Внешние URL-адреса
|
external_urls | ExternalUrl |
Известные внешние URL-адреса для этого объекта. |
|
Жанров
|
genres | array of |
Список жанров, используемых для классификации альбома. Например: Prog Rock, Post-Grunge. (Если массив еще не классифицирован, массив пуст.) |
|
Href
|
href | string |
Ссылка на конечную точку веб-API, предоставляющая полные сведения о альбоме. |
|
Идентификатор
|
id | string |
Идентификатор Spotify для альбома. |
|
Изображения
|
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 |
Тип объекта: "альбом" |
|
URI
|
uri | string |
URI Spotify для альбома. |
AlbumRestriction
Художник
Исполнительские художники.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Внешние URL-адреса
|
external_urls | ExternalUrl |
Известные внешние URL-адреса для этого объекта. |
|
Href
|
href | string |
Ссылка на конечную точку веб-API, предоставляющая полные сведения о художнике. |
|
Идентификатор
|
id | string |
Идентификатор Spotify для художника. |
|
Имя
|
name | string |
Имя художника. |
|
Тип
|
type | string |
Тип объекта: "художник" |
|
URI
|
uri | string |
URI Spotify для художника. |
Авторские права
Заявления об авторских правах.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Текст
|
text | string |
Текст авторских прав для этого содержимого. |
|
Тип
|
type | string |
Тип авторских прав: C = авторские права, P = звукозапись (производительность) авторских прав. |
ExplicitContentSettings
Явные параметры содержимого пользователя.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Включен фильтр
|
filter_enabled | boolean |
Если значение true, указывает, что явное содержимое не должно воспроизводиться. |
|
Фильтр заблокирован
|
filter_locked | boolean |
Если значение true, указывает, что явный параметр содержимого заблокирован и не может быть изменен пользователем. |
ExternalId
Известные внешние идентификаторы для альбома.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
EAN
|
ean | string |
Номер международной статьи. |
|
ISRC
|
isrc | string |
Международный стандартный код записи. |
|
МЗ
|
upc | string |
Универсальный код продукта. |
ExternalUrl
Известные внешние URL-адреса для этого объекта.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Spotify
|
spotify | string |
URL-адрес Spotify для объекта. |
Подписчики
Сведения о последователях.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
href
|
href | string |
href |
|
итог
|
total | integer |
итог |
Изображение
Изображение, принадлежащее объекту.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
height
|
height | integer |
height |
|
URL-адрес
|
url | string |
URL-адрес |
|
Ширина
|
width | integer |
Ширина |
LinkedTrack
PrivateUser
Сведения о частном пользователе.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Страна
|
country | string |
Страна пользователя, заданная в профиле учетной записи пользователя. |
|
Отображаемое имя
|
display_name | string |
Имя, отображаемое в профиле пользователя. |
|
Адрес электронной почты
|
string |
Адрес электронной почты пользователя. |
|
|
Явные параметры содержимого
|
explicit_content | ExplicitContentSettings |
Явные параметры содержимого пользователя. |
|
Внешние URL-адреса
|
external_urls | ExternalUrl |
Известные внешние URL-адреса для этого объекта. |
|
Подписчики
|
followers | Followers |
Сведения о последователях. |
|
Href
|
href | string |
Ссылка на конечную точку веб-API для этого пользователя. |
|
Идентификатор
|
id | string |
Идентификатор Spotify для пользователя. |
|
Изображение
|
images | Image |
Изображение, принадлежащее объекту. |
|
Продукт
|
product | string |
Уровень подписки Spotify пользователя: "Премиум", "бесплатный" и т. д. (Уровень подписки "открытый" можно считать таким же, как "бесплатный". |
|
Тип
|
type | string |
Тип объекта: user |
|
URI
|
uri | string |
URI Spotify для пользователя. |
Упрощенная версияAlbum
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Группа альбомов
|
album_group | string |
Поле присутствует при получении альбомов художника. Возможные значения: "альбом", "single", "компиляция", "appears_on". Сравните с album_type это поле представляет связь между художником и альбомом. |
|
Тип альбома
|
album_type | string |
Тип альбома: один из альбомов, "сингл" или "компиляция". |
|
Художников
|
artists | array of SimplifiedArtist |
Художники альбома. Каждый объект художника содержит ссылку в href, чтобы получить более подробную информацию о художнике. |
|
Доступные рынки
|
available_markets | array of string |
Рынки, в которых доступен альбом: коды стран ISO 3166-1 альфа-2. |
|
Внешние URL-адреса
|
external_urls | ExternalUrl |
Известные внешние URL-адреса для этого объекта. |
|
Href
|
href | string |
Ссылка на конечную точку веб-API, предоставляющая полные сведения о альбоме. |
|
Идентификатор
|
id | string |
Идентификатор Spotify для альбома. |
|
Изображения
|
images | array of Image |
Обложка для альбома в различных размерах, самый широкий первый. |
|
Имя
|
name | string |
Имя альбома. В случае сбоем альбома значение может быть пустой строкой. |
|
Тип
|
type | string |
Тип объекта: "альбом" |
|
URI
|
uri | string |
URI Spotify для альбома. |
Упрощенныйartist
Исполнительские художники.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Внешние URL-адреса
|
external_urls | ExternalUrl |
Известные внешние URL-адреса для этого объекта. |
|
Href
|
href | string |
Ссылка на конечную точку веб-API, предоставляющая полные сведения о художнике. |
|
Идентификатор
|
id | string |
Идентификатор Spotify для художника. |
|
Имя
|
name | string |
Имя художника. |
|
Тип
|
type | string |
Тип объекта: "художник" |
|
URI
|
uri | string |
URI Spotify для художника. |
Упрощенное отслеживание
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Художников
|
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 = нет, он не или неизвестно). |
|
Внешние URL-адреса
|
external_urls | ExternalUrl |
Известные внешние URL-адреса для этого объекта. |
|
Href
|
href | string |
Ссылка на конечную точку веб-API, предоставляющую полные сведения о треке. |
|
Идентификатор
|
id | string |
Идентификатор Spotify для трека. |
|
Локальный
|
is_local | boolean |
Независимо от того, находится ли трек из локального файла. |
|
Играемая
|
is_playable | boolean |
Часть ответа при применении повторного связывания трека. Если значение true, трек можно играть на данном рынке. В противном случае значение false. |
|
linked_from
|
linked_from | LinkedTrack | |
|
Имя
|
name | string |
Имя дорожки. |
|
URL-адрес предварительной версии
|
preview_url | string |
URL-адрес для 30-секундной предварительной версии (ФОРМАТ MP3) дорожки. |
|
Ограничения
|
restrictions | TrackRestriction |
Причина ограничения. |
|
Отслеживание номера
|
track_number | integer |
Количество трека. Если альбом содержит несколько дисков, номер трека — это номер на указанном диске. |
|
Тип
|
type | string |
Тип объекта: track. |
|
URI
|
uri | string |
URI Spotify для трека. |