Class: AppleMusic::Artist
- Defined in:
- lib/apple_music/artist.rb,
lib/apple_music/artist/attributes.rb,
lib/apple_music/artist/relationships.rb
Overview
Defined Under Namespace
Classes: Attributes, Relationships
Constant Summary
Constants inherited from Resource
Instance Attribute Summary
Attributes inherited from Resource
#attributes, #href, #id, #relationships, #type
Class Method Summary collapse
-
.find(id, **options) ⇒ Object
e.g.
-
.get_collection_by_ids(ids, **options) ⇒ Object
e.g.
-
.get_relationship(id, relationship_type, **options) ⇒ Object
e.g.
-
.list(**options) ⇒ Object
e.g.
-
.related_albums(id, **options) ⇒ Object
e.g.
-
.related_genres(id, **options) ⇒ Object
e.g.
-
.related_playlists(id, **options) ⇒ Object
e.g.
-
.related_station(id, **options) ⇒ Object
e.g.
- .search(term, **options) ⇒ Object
Methods inherited from Resource
Constructor Details
This class inherits a constructor from AppleMusic::Resource
Dynamic Method Handling
This class handles dynamic methods through the method_missing method in the class AppleMusic::Resource
Class Method Details
.find(id, **options) ⇒ Object
e.g. AppleMusic::Artist.find(178834) developer.apple.com/documentation/applemusicapi/get_a_catalog_artist
9 10 11 12 13 |
# File 'lib/apple_music/artist.rb', line 9 def find(id, **) storefront = Storefront.lookup(.delete(:storefront)) response = AppleMusic.get("catalog/#{storefront}/artists/#{id}", ) Response.new(response.body).data.first end |
.get_collection_by_ids(ids, **options) ⇒ Object
e.g. AppleMusic::Artist.get_collection_by_ids([178834, 462006]) developer.apple.com/documentation/applemusicapi/get_multiple_catalog_artists
24 25 26 27 28 29 |
# File 'lib/apple_music/artist.rb', line 24 def get_collection_by_ids(ids, **) ids = ids.is_a?(Array) ? ids.join(',') : ids storefront = Storefront.lookup(.delete(:storefront)) response = AppleMusic.get("catalog/#{storefront}/artists", .merge(ids: ids)) Response.new(response.body).data end |
.get_relationship(id, relationship_type, **options) ⇒ Object
e.g. AppleMusic::Artist.get_relationship(178834, :albums) developer.apple.com/documentation/applemusicapi/get_a_catalog_artist_s_relationship_directly_by_name
33 34 35 36 37 |
# File 'lib/apple_music/artist.rb', line 33 def get_relationship(id, relationship_type, **) storefront = Storefront.lookup(.delete(:storefront)) response = AppleMusic.get("catalog/#{storefront}/artists/#{id}/#{relationship_type}", ) Response.new(response.body).data end |
.list(**options) ⇒ Object
e.g. AppleMusic::Artist.list(ids: [178834, 462006])
16 17 18 19 20 |
# File 'lib/apple_music/artist.rb', line 16 def list(**) raise ParameterMissing, 'required parameter :ids is missing' unless [:ids] get_collection_by_ids(.delete(:ids), ) end |
.related_albums(id, **options) ⇒ Object
e.g. AppleMusic::Artist.related_albums(178834)
40 41 42 |
# File 'lib/apple_music/artist.rb', line 40 def (id, **) get_relationship(id, :albums, ) end |
.related_genres(id, **options) ⇒ Object
e.g. AppleMusic::Artist.related_genres(178834)
45 46 47 |
# File 'lib/apple_music/artist.rb', line 45 def (id, **) get_relationship(id, :genres, ) end |
.related_playlists(id, **options) ⇒ Object
e.g. AppleMusic::Artist.related_playlists(178834)
50 51 52 |
# File 'lib/apple_music/artist.rb', line 50 def (id, **) get_relationship(id, :playlists, ) end |
.related_station(id, **options) ⇒ Object
e.g. AppleMusic::Artist.related_station(178834)
55 56 57 |
# File 'lib/apple_music/artist.rb', line 55 def (id, **) get_relationship(id, :station, ).first end |
.search(term, **options) ⇒ Object
59 60 61 |
# File 'lib/apple_music/artist.rb', line 59 def search(term, **) AppleMusic.search(**.merge(term: term, types: :artists)).artists end |