Method: musicTracks.list
Stay organized with collections
Save and categorize content based on your preferences.
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.
|
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-09-15 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]