Method: musicTracks.list

Retrieves a list of music tracks.

HTTP request

GET https://youtubepartner.googleapis.com/youtube/partner/v1/music/{parent=releases/*}/tracks

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent release, which contains this list of tracks. Format: releases/{release}

Query parameters

Parameters
pageSize

integer

The maximum number of tracks to return. The service may return fewer than this value. If unspecified, at most 30 tracks will be returned. The maximum value is 50; values above 50 will be coerced to 50.
pageToken

string

A page token, received from a previous musicTracks.list call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to musicTracks.list must match the call that provided the page token.
onBehalfOfContentOwner

string

Identifies the content owner that the user is acting on behalf of. This parameter supports users whose accounts are associated with multiple content owners.
filter

object (TrackFilter)

Filtering based on various parameters in musicTracks.list.

Request body

The request body must be empty.

Response body

A response to list music tracks.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "tracks": [
    {
      object (MusicTrack)
    }
  ],
  "nextPageToken": string
}
Fields
tracks[]

object (MusicTrack)

The requested music tracks.
nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/youtubepartner

For more information, see the OAuth 2.0 Overview.

TrackFilter

Representation of an expression for filtering in musicTracks.list. We always take the conjunction (logical AND) of the filters, so a track must meet all criteria to be returned.

JSON representation 
{
  "isrcs": [
    string
  ],
  "upcs": [
    string
  ],
  "titleMatches": string,
  "artistNameMatches": string,
  "externalVideoIds": [
    string
  ],
  "hasOpenChangeRequest": boolean,
  "hasClosedChangeRequest": boolean
}
Fields
isrcs[]

string

A list of case insensitive ISRCs of the tracks to be retrieved.
upcs[]

string

A list of case insensitive UPCs of the tracks to be retrieved.
titleMatches

string

Tokenized search (case insensitive).
artistNameMatches

string

Tokenized search (case insensitive).
externalVideoIds[]

string

A list of case insensitive external videoIds of the tracks to be retrieved.
hasOpenChangeRequest

boolean

At least one ChangeRequest in open status.
hasClosedChangeRequest

boolean

At least one ChangeRequest in closed status.