Method: musicTracks.list

Spark icon

Page Summary

This endpoint retrieves a list of music tracks associated with a specific release using a GET request to the provided URL, which follows gRPC Transcoding syntax.
The request requires a parent path parameter, which specifies the release containing the tracks, and supports several query parameters, such as pageSize, pageToken, onBehalfOfContentOwner, and filter for customizing the results.
The request body must be empty, and the successful response body will include an array of tracks and an optional nextPageToken for pagination.
Filtering of the results can be done through the use of the filter query parameter, utilizing properties such as isrcs, upcs, titleMatches, artistNameMatches, externalVideoIds, and whether there are open or closed change requests.
Authorization for this request requires the https://www.googleapis.com/auth/youtubepartner OAuth scope.

HTTP request
Path parameters
Query parameters
Request body
Response body
- JSON representation
Authorization scopes
TrackFilter
- JSON representation
Try it!

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

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

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

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.

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.