spotifywebapiPython 1.0.262__py3-none-any.whl → 1.0.264__py3-none-any.whl

spotifywebapipython/spotifyclient.py

@@ -67,6 +67,10 @@ from .const import (
 
 CACHE_SOURCE_CACHED:str = "cached"
 CACHE_SOURCE_CURRENT:str = "current"
+CACHE_KEY_GETSPOTIFYCONNECTDEVICES:str = "GetSpotifyConnectDevices"
+
+MUSIC_SOURCE_SPOTIFY_LOCAL_QUEUE:str = "SPOTIFY_LOCAL_QUEUE"
+MUSIC_SOURCE_SPOTIFY_CONNECT:str = "SPOTIFY_CONNECT"
 
 DELAY_DISCONNECT:float = 0.350
 """
@@ -1084,6 +1088,10 @@ class SpotifyClient:
             # Spotify Connect devices on the local network.  
             self._SpotifyConnectDirectory.WaitForInitComplete.wait()
 
+            # load initial configuration cache with devices we have found thus far.
+            # no need to refresh, since they were just loaded (just loads the cache).
+            self.GetSpotifyConnectDevices(refresh=False)
+
             # trace.
             _logsi.LogVerbose("Spotify Connect Directory task was started and initialized successfully")
 
@@ -3834,14 +3842,6 @@ class SpotifyClient:
         market:str=None,
         ) -> list[Album]:
         """
-        <span class="deprecated">
-            DEPRECATED - api endpoint no longer supported by Spotify as of 2026/02/11 for unauthorized Spotify Developer Applications.
-            The api endpoint IS still supported by Spotify for authorized Spotify Developer Applications.
-            More information about the deprecated functionality can be found on the 
-            <a href="https://developer.spotify.com/blog/2026-02-06-update-on-developer-access-and-platform-security" target="_blank">Spotify Developer Forum Blog</a>
-            page.
-        </span>       
-
         Get Spotify catalog information for multiple albums.
         
         Args:
@@ -3887,37 +3887,42 @@ class SpotifyClient:
             apiMethodParms.AppendKeyValue("market", market)
             _logsi.LogMethodParmList(SILevel.Verbose, "Get Spotify catalog information for multiple albums", apiMethodParms)
 
-            # are spotify web player credentials configured? if so, then we will use them to create
-            # an elevated authorization access token for the Spotify Web API endpoint call.
-            accessTokenHeaderValue:str = self._GetSpotifyWebPlayerTokenHeaderValue()
-
-            # if spotify web player credentials not configured then we are done; the Spotify Web API
-            # endpoint is no longer supported by unauthorized Spotify Developer Applications as of 2026/02/11.
-            if (accessTokenHeaderValue is None):
-                raise SpotifyApiError(SAAppMessages.MSG_SPOTIFY_DEPRECATED_ENDPOINT_20260211 % apiMethodName)
-                
             # ensure we have a market value, in order to return track relinking (e.g. `linked_from`) data.
             market = self._ValidateMarket(market, forceReturnValue=True)
 
-            # build spotify web api request parameters.
-            urlParms:dict = \
-            {
-                'ids': ids,
-            }
-            if market is not None:
-                urlParms['market'] = market
-
-            # execute spotify web api request.
-            msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/albums')
-            msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
-            msg.UrlParameters = urlParms
-            self.MakeRequest('GET', msg)
+            # if ids not specified, then we are done.
+            if (ids is None) or (len(ids.strip()) == 0):
+                raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
 
-            # process results.
-            items = msg.ResponseData.get('albums',None)
-            if items is not None:
-                for item in items:
-                    result.append(Album(root=item))
+            # build list of all input item id's, and retrieve them one-by-one.
+            ids = ids.replace(" ", "")
+            arrIds:list[str] = ids.split(',')
+            for strId in arrIds:
+                result.append(self.GetAlbum(strId, market))
+
+            # ------------------------------------------------------------------------------------------
+            # the following is the pre-2026/02/11 endpoint for retrieving this information.
+            # ------------------------------------------------------------------------------------------
+
+            # # build spotify web api request parameters.
+            # urlParms:dict = \
+            # {
+            #     'ids': ids,
+            # }
+            # if market is not None:
+            #     urlParms['market'] = market
+
+            # # execute spotify web api request.
+            # msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/albums')
+            # msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
+            # msg.UrlParameters = urlParms
+            # self.MakeRequest('GET', msg)
+
+            # # process results.
+            # items = msg.ResponseData.get('albums',None)
+            # if items is not None:
+            #     for item in items:
+            #         result.append(Album(root=item))
         
             # trace.
             _logsi.LogArray(SILevel.Verbose, TRACE_METHOD_RESULT_TYPE % (apiMethodName, 'list[Album]'), result)
@@ -4834,14 +4839,6 @@ class SpotifyClient:
         ids:list[str], 
         ) -> list[Artist]:
         """
-        <span class="deprecated">
-            DEPRECATED - api endpoint no longer supported by Spotify as of 2026/02/11 for unauthorized Spotify Developer Applications.
-            The api endpoint IS still supported by Spotify for authorized Spotify Developer Applications.
-            More information about the deprecated functionality can be found on the 
-            <a href="https://developer.spotify.com/blog/2026-02-06-update-on-developer-access-and-platform-security" target="_blank">Spotify Developer Forum Blog</a>
-            page.
-        </span>       
-
         Get Spotify catalog information for several artists based on their Spotify IDs.
         
         Args:
@@ -4878,32 +4875,37 @@ class SpotifyClient:
             apiMethodParms.AppendKeyValue("ids", ids)
             _logsi.LogMethodParmList(SILevel.Verbose, "Get Spotify catalog information for multiple artists", apiMethodParms)
                 
-            # are spotify web player credentials configured? if so, then we will use them to create
-            # an elevated authorization access token for the Spotify Web API endpoint call.
-            accessTokenHeaderValue:str = self._GetSpotifyWebPlayerTokenHeaderValue()
+            # if ids not specified, then we are done.
+            if (ids is None) or (len(ids.strip()) == 0):
+                raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
 
-            # if spotify web player credentials not configured then we are done; the Spotify Web API
-            # endpoint is no longer supported by unauthorized Spotify Developer Applications as of 2026/02/11.
-            if (accessTokenHeaderValue is None):
-                raise SpotifyApiError(SAAppMessages.MSG_SPOTIFY_DEPRECATED_ENDPOINT_20260211 % apiMethodName)
+            # build list of all input item id's, and retrieve them one-by-one.
+            ids = ids.replace(" ", "")
+            arrIds:list[str] = ids.split(',')
+            for strId in arrIds:
+                result.append(self.GetArtist(strId))
 
-            # build spotify web api request parameters.
-            urlParms:dict = \
-            {
-                'ids': ids
-            }
+            # ------------------------------------------------------------------------------------------
+            # the following is the pre-2026/02/11 endpoint for retrieving this information.
+            # ------------------------------------------------------------------------------------------
 
-            # execute spotify web api request.
-            msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/artists')
-            msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
-            msg.UrlParameters = urlParms
-            self.MakeRequest('GET', msg)
+            # # build spotify web api request parameters.
+            # urlParms:dict = \
+            # {
+            #     'ids': ids
+            # }
 
-            # process results.
-            items = msg.ResponseData.get('artists',None)
-            if items is not None:
-                for item in items:
-                    result.append(Artist(root=item))
+            # # execute spotify web api request.
+            # msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/artists')
+            # msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
+            # msg.UrlParameters = urlParms
+            # self.MakeRequest('GET', msg)
+
+            # # process results.
+            # items = msg.ResponseData.get('artists',None)
+            # if items is not None:
+            #     for item in items:
+            #         result.append(Artist(root=item))
         
             # trace.
             _logsi.LogArray(SILevel.Verbose, TRACE_METHOD_RESULT_TYPE % (apiMethodName, 'list[Artist]'), result)
@@ -5658,14 +5660,6 @@ class SpotifyClient:
         market:str=None,
         ) -> list[AudiobookSimplified]:
         """
-        <span class="deprecated">
-            DEPRECATED - api endpoint no longer supported by Spotify as of 2026/02/11 for unauthorized Spotify Developer Applications.
-            The api endpoint IS still supported by Spotify for authorized Spotify Developer Applications.
-            More information about the deprecated functionality can be found on the 
-            <a href="https://developer.spotify.com/blog/2026-02-06-update-on-developer-access-and-platform-security" target="_blank">Spotify Developer Forum Blog</a>
-            page.
-        </span>       
-
         Get Spotify catalog information for several audiobooks based on their Spotify IDs.
         
         Args:
@@ -5692,6 +5686,8 @@ class SpotifyClient:
             SpotifyApiError: 
                 If the method fails for any other reason.
 
+        Note that `AudiobookSimplified` details do not contain chapter data.
+
         Important policy notes:  
         - Spotify content may not be downloaded.  
         - Keep visual content in its original form.  
@@ -5716,37 +5712,45 @@ class SpotifyClient:
             apiMethodParms.AppendKeyValue("market", market)
             _logsi.LogMethodParmList(SILevel.Verbose, "Get Spotify catalog information for multiple audiobooks", apiMethodParms)
                 
-            # are spotify web player credentials configured? if so, then we will use them to create
-            # an elevated authorization access token for the Spotify Web API endpoint call.
-            accessTokenHeaderValue:str = self._GetSpotifyWebPlayerTokenHeaderValue()
-
-            # if spotify web player credentials not configured then we are done; the Spotify Web API
-            # endpoint is no longer supported by unauthorized Spotify Developer Applications as of 2026/02/11.
-            if (accessTokenHeaderValue is None):
-                raise SpotifyApiError(SAAppMessages.MSG_SPOTIFY_DEPRECATED_ENDPOINT_20260211 % apiMethodName)
-
             # ensure market was either supplied or implied; default if neither.
             market = self._ValidateMarket(market)
 
-            # build spotify web api request parameters.
-            urlParms:dict = \
-            {
-                'ids': ids,
-            }
-            if market is not None:
-                urlParms['market'] = market
-
-            # execute spotify web api request.
-            msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/audiobooks')
-            msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
-            msg.UrlParameters = urlParms
-            self.MakeRequest('GET', msg)
+            # if ids not specified, then we are done.
+            if (ids is None) or (len(ids.strip()) == 0):
+                raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
 
-            # process results.
-            items = msg.ResponseData.get('audiobooks',None)
-            if items is not None:
-                for item in items:
-                    result.append(AudiobookSimplified(root=item))
+            # build list of all input item id's, and retrieve them one-by-one.
+            ids = ids.replace(" ", "")
+            arrIds:list[str] = ids.split(',')
+            for strId in arrIds:
+                dataObj = self.GetAudiobook(strId, market)
+                # convert Audiobook object to a AudiobookSimplified object.
+                dataObj._Chapters = None
+                result.append(dataObj)
+
+            # ------------------------------------------------------------------------------------------
+            # the following is the pre-2026/02/11 endpoint for retrieving this information.
+            # ------------------------------------------------------------------------------------------
+
+            # # build spotify web api request parameters.
+            # urlParms:dict = \
+            # {
+            #     'ids': ids,
+            # }
+            # if market is not None:
+            #     urlParms['market'] = market
+
+            # # execute spotify web api request.
+            # msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/audiobooks')
+            # msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
+            # msg.UrlParameters = urlParms
+            # self.MakeRequest('GET', msg)
+
+            # # process results.
+            # items = msg.ResponseData.get('audiobooks',None)
+            # if items is not None:
+            #     for item in items:
+            #         result.append(AudiobookSimplified(root=item))
         
             # trace.
             _logsi.LogArray(SILevel.Verbose, TRACE_METHOD_RESULT_TYPE % (apiMethodName, 'list[AudiobookSimplified]'), result)
@@ -6530,14 +6534,6 @@ class SpotifyClient:
         market:str=None,
         ) -> list[Chapter]:
         """
-        <span class="deprecated">
-            DEPRECATED - api endpoint no longer supported by Spotify as of 2026/02/11 for unauthorized Spotify Developer Applications.
-            The api endpoint IS still supported by Spotify for authorized Spotify Developer Applications.
-            More information about the deprecated functionality can be found on the 
-            <a href="https://developer.spotify.com/blog/2026-02-06-update-on-developer-access-and-platform-security" target="_blank">Spotify Developer Forum Blog</a>
-            page.
-        </span>       
-
         Get Spotify catalog information for several chapters based on their Spotify IDs.
         
         Args:
@@ -6588,37 +6584,42 @@ class SpotifyClient:
             apiMethodParms.AppendKeyValue("market", market)
             _logsi.LogMethodParmList(SILevel.Verbose, "Get Spotify catalog information for multiple chapters", apiMethodParms)
                 
-            # are spotify web player credentials configured? if so, then we will use them to create
-            # an elevated authorization access token for the Spotify Web API endpoint call.
-            accessTokenHeaderValue:str = self._GetSpotifyWebPlayerTokenHeaderValue()
-
-            # if spotify web player credentials not configured then we are done; the Spotify Web API
-            # endpoint is no longer supported by unauthorized Spotify Developer Applications as of 2026/02/11.
-            if (accessTokenHeaderValue is None):
-                raise SpotifyApiError(SAAppMessages.MSG_SPOTIFY_DEPRECATED_ENDPOINT_20260211 % apiMethodName)
-
             # ensure market was either supplied or implied; default if neither.
             market = self._ValidateMarket(market)
 
-            # build spotify web api request parameters.
-            urlParms:dict = \
-            {
-                'ids': ids,
-            }
-            if market is not None:
-                urlParms['market'] = market
-
-            # execute spotify web api request.
-            msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/chapters')
-            msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
-            msg.UrlParameters = urlParms
-            self.MakeRequest('GET', msg)
+            # if ids not specified, then we are done.
+            if (ids is None) or (len(ids.strip()) == 0):
+                raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
 
-            # process results.
-            items = msg.ResponseData.get('chapters',None)
-            if items is not None:
-                for item in items:
-                    result.append(Chapter(root=item))
+            # build list of all input item id's, and retrieve them one-by-one.
+            ids = ids.replace(" ", "")
+            arrIds:list[str] = ids.split(',')
+            for strId in arrIds:
+                result.append(self.GetChapter(strId, market))
+
+            # ------------------------------------------------------------------------------------------
+            # the following is the pre-2026/02/11 endpoint for retrieving this information.
+            # ------------------------------------------------------------------------------------------
+
+            # # build spotify web api request parameters.
+            # urlParms:dict = \
+            # {
+            #     'ids': ids,
+            # }
+            # if market is not None:
+            #     urlParms['market'] = market
+
+            # # execute spotify web api request.
+            # msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/chapters')
+            # msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
+            # msg.UrlParameters = urlParms
+            # self.MakeRequest('GET', msg)
+
+            # # process results.
+            # items = msg.ResponseData.get('chapters',None)
+            # if items is not None:
+            #     for item in items:
+            #         result.append(Chapter(root=item))
         
             # trace.
             _logsi.LogArray(SILevel.Verbose, TRACE_METHOD_RESULT_TYPE % (apiMethodName, 'list[Chapter]'), result)
@@ -6844,9 +6845,17 @@ class SpotifyClient:
                     # get Sonos playback state via Sonos Controller instance.
                     playerStateSonos:PlayerPlayState = self.GetPlayerPlaybackStateSonos(scDevice)
 
-                    # return the device playstate.
-                    _logsi.LogVerbose("Sonos device %s playstate will be returned" % (scDevice.Title))
-                    result = playerStateSonos
+                    # is the device still playing spotify content?
+                    if (playerStateSonos.DeviceMusicSource in [MUSIC_SOURCE_SPOTIFY_CONNECT, MUSIC_SOURCE_SPOTIFY_LOCAL_QUEUE]):
+
+                        # yes - return the device playstate.
+                        _logsi.LogVerbose("Sonos device %s playstate will be returned (music source=\"%s\")" % (scDevice.Title, playerStateSonos.DeviceMusicSource))
+                        result = playerStateSonos
+
+                    else:
+
+                        # no - return an empty playstate.
+                        _logsi.LogVerbose("Sonos device %s music source (%s) is not Spotify; an empty playstate will be returned" % (scDevice.Title, playerStateSonos.DeviceMusicSource))
 
                     # did Sonos Controller instance return a playstate?
                     # if so, then update the player last played info if something is playing.
@@ -7141,14 +7150,6 @@ class SpotifyClient:
         market:str=None,
         ) -> list[Episode]:
         """
-        <span class="deprecated">
-            DEPRECATED - api endpoint no longer supported by Spotify as of 2026/02/11 for unauthorized Spotify Developer Applications.
-            The api endpoint IS still supported by Spotify for authorized Spotify Developer Applications.
-            More information about the deprecated functionality can be found on the 
-            <a href="https://developer.spotify.com/blog/2026-02-06-update-on-developer-access-and-platform-security" target="_blank">Spotify Developer Forum Blog</a>
-            page.
-        </span>       
-
         Get Spotify catalog information for several episodes based on their Spotify IDs.
         
         Args:
@@ -7199,37 +7200,42 @@ class SpotifyClient:
             apiMethodParms.AppendKeyValue("market", market)
             _logsi.LogMethodParmList(SILevel.Verbose, "Get Spotify catalog information for multiple episodes", apiMethodParms)
                 
-            # are spotify web player credentials configured? if so, then we will use them to create
-            # an elevated authorization access token for the Spotify Web API endpoint call.
-            accessTokenHeaderValue:str = self._GetSpotifyWebPlayerTokenHeaderValue()
-
-            # if spotify web player credentials not configured then we are done; the Spotify Web API
-            # endpoint is no longer supported by unauthorized Spotify Developer Applications as of 2026/02/11.
-            if (accessTokenHeaderValue is None):
-                raise SpotifyApiError(SAAppMessages.MSG_SPOTIFY_DEPRECATED_ENDPOINT_20260211 % apiMethodName)
-
             # ensure market was either supplied or implied; default if neither.
             market = self._ValidateMarket(market)
 
-            # build spotify web api request parameters.
-            urlParms:dict = \
-            {
-                'ids': ids,
-            }
-            if market is not None:
-                urlParms['market'] = market
-
-            # execute spotify web api request.
-            msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/episodes')
-            msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
-            msg.UrlParameters = urlParms
-            self.MakeRequest('GET', msg)
+            # if ids not specified, then we are done.
+            if (ids is None) or (len(ids.strip()) == 0):
+                raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
 
-            # process results.
-            items = msg.ResponseData.get('episodes',None)
-            if items is not None:
-                for item in items:
-                    result.append(Episode(root=item))
+            # build list of all input item id's, and retrieve them one-by-one.
+            ids = ids.replace(" ", "")
+            arrIds:list[str] = ids.split(',')
+            for strId in arrIds:
+                result.append(self.GetEpisode(strId, market))
+
+            # ------------------------------------------------------------------------------------------
+            # the following is the pre-2026/02/11 endpoint for retrieving this information.
+            # ------------------------------------------------------------------------------------------
+
+            # # build spotify web api request parameters.
+            # urlParms:dict = \
+            # {
+            #     'ids': ids,
+            # }
+            # if market is not None:
+            #     urlParms['market'] = market
+
+            # # execute spotify web api request.
+            # msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/episodes')
+            # msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
+            # msg.UrlParameters = urlParms
+            # self.MakeRequest('GET', msg)
+
+            # # process results.
+            # items = msg.ResponseData.get('episodes',None)
+            # if items is not None:
+            #     for item in items:
+            #         result.append(Episode(root=item))
         
             # trace.
             _logsi.LogArray(SILevel.Verbose, TRACE_METHOD_RESULT_TYPE % (apiMethodName, 'list[Episode]'), result)
@@ -8705,18 +8711,25 @@ class SpotifyClient:
                         else:
                             result.ItemType = SpotifyMediaTypes.PODCAST.value
         
-            # check for a restricted device; if found, then grab the device id from the 
-            # cached list of spotify connect devices (if present).
+            # if device id is not present (e.g. a restricted device), then get the device id 
+            # from the cached list of spotify connect devices (if present).
             if (not result.IsEmpty):
                 device:Device = result.Device
                 if (device is not None) and (device.Id is None or device.Id == ''):
-                    cacheKey:str = 'GetSpotifyConnectDevices'
+                    cacheKey:str = CACHE_KEY_GETSPOTIFYCONNECTDEVICES
                     if (cacheKey in self._ConfigurationCache):
                         devices:SpotifyConnectDevices = self._ConfigurationCache[cacheKey]
                         scDevice:SpotifyConnectDevice = devices.GetDeviceByName(device.Name)
                         if scDevice is not None:
                             device.Id = scDevice.DeviceInfo.DeviceId
-        
+                            # is this a Sonos device? if so, then update the music source.
+                            # at this point, it will probably be "SPOTIFY_CONNECT" since it was
+                            # detected in the Spotify Web API device list.
+                            if (scDevice.IsSonos):
+                                sonosPlayer = self._SpotifyConnectDirectory.GetSonosPlayer(scDevice)
+                                if (sonosPlayer):
+                                    result.DeviceMusicSource = sonosPlayer.music_source
+
             # did Spotify return a playstate?
             # if so, then update the player last played info if something is playing.
             if (not result.IsEmpty):
@@ -8796,6 +8809,16 @@ class SpotifyClient:
             playerState.IsDeviceState = True
             playerState.DeviceMusicSource = "" + str(sonosPlayer.music_source)
 
+            # at this point, the the device music_source is probably set to one of the following:
+            # - "UNKNOWN": indicates that Spotify is POSSIBLY playing from the Sonos local queue.
+            # - "SPOTIFY_CONNECT": indicates that Spotify is playing via Spotify Connect using Spotify App.
+            # if not SPOTIFY_CONNECT, then check the currently playing track info to see if it's
+            # a Spotify uri; if so, then it's (probably) playing Spotify from the local queue, so 
+            # we will set the music source to the "SPOTIFY_LOCAL_QUEUE" custom value.
+            if (playerState.DeviceMusicSource != MUSIC_SOURCE_SPOTIFY_CONNECT):
+                if (sonosTrackInfo.get('uri','').startswith("x-sonos-spotify:")):
+                    playerState.DeviceMusicSource = MUSIC_SOURCE_SPOTIFY_LOCAL_QUEUE
+
             # update Spotify Web API player state with Sonos player state.
             playerState._Device._Id = scDevice.Id
             playerState._Device._Name = sonosPlayer.player_name
@@ -10492,14 +10515,6 @@ class SpotifyClient:
         market:str=None,
         ) -> list[ShowSimplified]:
         """
-        <span class="deprecated">
-            DEPRECATED - api endpoint no longer supported by Spotify as of 2026/02/11 for unauthorized Spotify Developer Applications.
-            The api endpoint IS still supported by Spotify for authorized Spotify Developer Applications.
-            More information about the deprecated functionality can be found on the 
-            <a href="https://developer.spotify.com/blog/2026-02-06-update-on-developer-access-and-platform-security" target="_blank">Spotify Developer Forum Blog</a>
-            page.
-        </span>       
-
         Get Spotify catalog information for several shows based on their Spotify IDs.
         
         Args:
@@ -10526,6 +10541,8 @@ class SpotifyClient:
             SpotifyApiError: 
                 If the method fails for any other reason.
 
+        Note that `ShowSimplified` details do not contain episode data.
+
         Important policy notes:  
         - Spotify content may not be downloaded.  
         - Keep visual content in its original form.  
@@ -10550,37 +10567,45 @@ class SpotifyClient:
             apiMethodParms.AppendKeyValue("market", market)
             _logsi.LogMethodParmList(SILevel.Verbose, "Get Spotify catalog information for multiple shows", apiMethodParms)
                 
-            # are spotify web player credentials configured? if so, then we will use them to create
-            # an elevated authorization access token for the Spotify Web API endpoint call.
-            accessTokenHeaderValue:str = self._GetSpotifyWebPlayerTokenHeaderValue()
-
-            # if spotify web player credentials not configured then we are done; the Spotify Web API
-            # endpoint is no longer supported by unauthorized Spotify Developer Applications as of 2026/02/11.
-            if (accessTokenHeaderValue is None):
-                raise SpotifyApiError(SAAppMessages.MSG_SPOTIFY_DEPRECATED_ENDPOINT_20260211 % apiMethodName)
-
             # ensure market was either supplied or implied; default if neither.
             market = self._ValidateMarket(market)
 
-            # build spotify web api request parameters.
-            urlParms:dict = \
-            {
-                'ids': ids,
-            }
-            if market is not None:
-                urlParms['market'] = market
-
-            # execute spotify web api request.
-            msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/shows')
-            msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
-            msg.UrlParameters = urlParms
-            self.MakeRequest('GET', msg)
+            # if ids not specified, then we are done.
+            if (ids is None) or (len(ids.strip()) == 0):
+                raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
 
-            # process results.
-            items = msg.ResponseData.get('shows',None)
-            if items is not None:
-                for item in items:
-                    result.append(ShowSimplified(root=item))
+            # build list of all input item id's, and retrieve them one-by-one.
+            ids = ids.replace(" ", "")
+            arrIds:list[str] = ids.split(',')
+            for strId in arrIds:
+                dataObj = self.GetShow(strId, market)
+                # convert Show object to a ShowSimplified object.
+                dataObj._Episodes = None
+                result.append(dataObj)
+
+            # ------------------------------------------------------------------------------------------
+            # the following is the pre-2026/02/11 endpoint for retrieving this information.
+            # ------------------------------------------------------------------------------------------
+
+            # # build spotify web api request parameters.
+            # urlParms:dict = \
+            # {
+            #     'ids': ids,
+            # }
+            # if market is not None:
+            #     urlParms['market'] = market
+
+            # # execute spotify web api request.
+            # msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/shows')
+            # msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
+            # msg.UrlParameters = urlParms
+            # self.MakeRequest('GET', msg)
+
+            # # process results.
+            # items = msg.ResponseData.get('shows',None)
+            # if items is not None:
+            #     for item in items:
+            #         result.append(ShowSimplified(root=item))
         
             # trace.
             _logsi.LogArray(SILevel.Verbose, TRACE_METHOD_RESULT_TYPE % (apiMethodName, 'list[ShowSimplified]'), result)
@@ -10869,7 +10894,7 @@ class SpotifyClient:
                 # was the Sonos device music source set to SPOTIFY_CONNECT?
                 # if not, then issue a Disconnect to (hopefully) reset the music source. this should allow
                 # the subsequent Connect to re-establish a SPOTIFY_CONNECT music source on the Sonos device.
-                if sonosMusicSource != "SPOTIFY_CONNECT":
+                if sonosMusicSource != MUSIC_SOURCE_SPOTIFY_CONNECT:
                     _logsi.LogVerbose("Issuing Disconnect to Sonos Spotify Connect device %s" % (scDevice.Title))
                     zcfResult = zconn.Disconnect(ignoreStatusResult=True)
 
@@ -10893,7 +10918,7 @@ class SpotifyClient:
 
                 # was the Sonos device music source set to Spotify Connect?
                 # if not, then it's a lost cause at this point since it's probably in an UNKNOWN state.
-                if sonosMusicSource != "SPOTIFY_CONNECT":
+                if sonosMusicSource != MUSIC_SOURCE_SPOTIFY_CONNECT:
                     _logsi.LogVerbose("Sonos device %s music source after Connect is not SPOTIFY_CONNECT; it will probably fail to play" % (scDevice.Title))
                 elif (self.HasSpotifyWebPlayerCredentials):
                     # if using Spotify Web Player credentials, then we don't have to wait for device.
@@ -11048,7 +11073,7 @@ class SpotifyClient:
             result = self._SpotifyConnectDirectory.GetDevices()
 
             # update cache.
-            self._ConfigurationCache[apiMethodName] = result
+            self._ConfigurationCache[CACHE_KEY_GETSPOTIFYCONNECTDEVICES] = result
 
             # trace.
             _logsi.LogArray(SILevel.Verbose, TRACE_METHOD_RESULT_TYPE_CACHED % (apiMethodName, type(result).__name__, cacheDesc), result)
@@ -11491,14 +11516,6 @@ class SpotifyClient:
         market:str=None,
         ) -> list[Track]:
         """
-        <span class="deprecated">
-            DEPRECATED - api endpoint no longer supported by Spotify as of 2026/02/11 for unauthorized Spotify Developer Applications.
-            The api endpoint IS still supported by Spotify for authorized Spotify Developer Applications.
-            More information about the deprecated functionality can be found on the 
-            <a href="https://developer.spotify.com/blog/2026-02-06-update-on-developer-access-and-platform-security" target="_blank">Spotify Developer Forum Blog</a>
-            page.
-        </span>       
-
         Get Spotify catalog information for multiple tracks based on their Spotify IDs.
         
         Args:
@@ -11544,37 +11561,42 @@ class SpotifyClient:
             apiMethodParms.AppendKeyValue("market", market)
             _logsi.LogMethodParmList(SILevel.Verbose, "Get Spotify catalog information for multiple tracks", apiMethodParms)
 
-            # are spotify web player credentials configured? if so, then we will use them to create
-            # an elevated authorization access token for the Spotify Web API endpoint call.
-            accessTokenHeaderValue:str = self._GetSpotifyWebPlayerTokenHeaderValue()
-
-            # if spotify web player credentials not configured then we are done; the Spotify Web API
-            # endpoint is no longer supported by unauthorized Spotify Developer Applications as of 2026/02/11.
-            if (accessTokenHeaderValue is None):
-                raise SpotifyApiError(SAAppMessages.MSG_SPOTIFY_DEPRECATED_ENDPOINT_20260211 % apiMethodName)
-                            
             # ensure we have a market value, in order to return track relinking (e.g. `linked_from`) data.
             market = self._ValidateMarket(market, forceReturnValue=True)
 
-            # build spotify web api request parameters.
-            urlParms:dict = \
-            {
-                'ids': ids
-            }
-            if market is not None:
-                urlParms['market'] = market
-
-            # execute spotify web api request.
-            msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/tracks')
-            msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
-            msg.UrlParameters = urlParms
-            self.MakeRequest('GET', msg)
+            # if ids not specified, then we are done.
+            if (ids is None) or (len(ids.strip()) == 0):
+                raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
 
-            # process results.
-            items = msg.ResponseData.get('tracks',None)
-            if items is not None:
-                for item in items:
-                    result.append(Track(root=item))
+            # build list of all input item id's, and retrieve them one-by-one.
+            ids = ids.replace(" ", "")
+            arrIds:list[str] = ids.split(',')
+            for strId in arrIds:
+                result.append(self.GetTrack(strId, market))
+
+            # ------------------------------------------------------------------------------------------
+            # the following is the pre-2026/02/11 endpoint for retrieving this information.
+            # ------------------------------------------------------------------------------------------
+
+            # # build spotify web api request parameters.
+            # urlParms:dict = \
+            # {
+            #     'ids': ids
+            # }
+            # if market is not None:
+            #     urlParms['market'] = market
+
+            # # execute spotify web api request.
+            # msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/tracks')
+            # msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
+            # msg.UrlParameters = urlParms
+            # self.MakeRequest('GET', msg)
+
+            # # process results.
+            # items = msg.ResponseData.get('tracks',None)
+            # if items is not None:
+            #     for item in items:
+            #         result.append(Track(root=item))
         
             # trace.
             _logsi.LogArray(SILevel.Verbose, TRACE_METHOD_RESULT_TYPE % (apiMethodName, 'list[Track]'), result)