Method: musicTracks.list

    • 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.

    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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: