getExtendedMetadataText

Sonos uses the getExtendedMetadataText request to get more information about an item. This call is designed to be a follow-up to a getExtendedMetadata call.

Request parameters

NameTypeDescription
idstring (128)The unique ID of the item that Sonos is requesting extended metadata. This can be a track, album, artist, or other item type.
typestring (32)Enum type of text to get. This is the same enum text returned in the relatedText node of the getExtendedMetadata call for the SMAPI ID.

Response

NameTypeDescription
getExtendedMetadataTextResultstringThe actual body of the text.

Sample request

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getExtendedMetadataText xmlns="http://www.sonos.com/Services/1.1">
      <id>T:123456789</id>
      <type>ARTIST_BIO</type>
    </getExtendedMetadataText>
   </soap:Body>
</soap:Envelope>

Sample response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getExtendedMetadataTextResponse xmlns="http://www.sonos.com/Services/1.1">
      <getExtendedMetadataTextResult>
        [Body of text goes here.]
      </getExtendedMetadataTextResult>
    </getExtendedMetadataTextResponse>
  </soap:Body>
</soap:Envelope>