Method: musicChangeRequests.list
Stay organized with collections
Save and categorize content based on your preferences.
Retrieves a list of music change requests reported to a release or a track.
HTTP request
GET https://youtubepartner.googleapis.com/youtube/partner/v1/music/changeRequests
The URL uses gRPC Transcoding
syntax.
Query parameters
| Parameters |
pageSize
|
integer
The maximum number of change requests to return. The service may return fewer than this value. If unspecified, at most 30 change requests 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 ( ChangeRequestFilter
)
Filtering based on various parameters in musicChangeRequests.list.
|
Request body
The request body must be empty.
Response body
A response to list music change requests.
If successful, the response body contains data with the following structure:
| Fields |
changeRequests[]
|
object ( MusicChangeRequest
)
The requested music change requests.
|
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
.
ChangeRequestFilter
Representation of an expression for filtering in musicChangeRequests.list. We always take the conjunction (logical AND) of the filters, so a changeRequest must meet all criteria to be returned.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThis API endpoint retrieves a list of music change requests related to a specific release or track via a \u003ccode\u003eGET\u003c/code\u003e request to the provided URL.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter the results using various parameters, such as \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e, and \u003ccode\u003efilter\u003c/code\u003e, allowing for customized data retrieval.\u003c/p\u003e\n"],["\u003cp\u003eThe response contains an array of \u003ccode\u003echangeRequests\u003c/code\u003e, which represent the music change requests, and a \u003ccode\u003enextPageToken\u003c/code\u003e for accessing subsequent pages of results.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization to use this endpoint requires the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eChangeRequestFilter\u003c/code\u003e object allows for filtering change requests based on the parent release or track.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of music change requests via a `GET` HTTP request to `https://youtubepartner.googleapis.com/youtube/partner/v1/music/changeRequests`. Key actions include using query parameters like `pageSize`, `pageToken`, `onBehalfOfContentOwner`, and `filter` for pagination and filtering. The request body should be empty. The response body, in JSON format, includes an array of `changeRequests` and a `nextPageToken` for subsequent pages. Authorization requires the `https://www.googleapis.com/auth/youtubepartner` scope.\n"],null,["# Method: musicChangeRequests.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListMusicChangeRequestsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ChangeRequestFilter](#ChangeRequestFilter)\n - [JSON representation](#ChangeRequestFilter.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nRetrieves a list of music change requests reported to a release or a track.\n\n### HTTP request\n\n`GET https://youtubepartner.googleapis.com/youtube/partner/v1/music/changeRequests`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of change requests to return. The service may return fewer than this value. If unspecified, at most 30 change requests will be returned. The maximum value is 50; values above 50 will be coerced to 50. |\n| `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. |\n| `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. |\n| `filter` | `object (`[ChangeRequestFilter](/youtube/partner/reference/rest/v1/musicChangeRequests/list#ChangeRequestFilter)`)` Filtering based on various parameters in musicChangeRequests.list. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA response to list music change requests.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"changeRequests\": [ { object (/youtube/partner/reference/rest/v1/musicChangeRequests#MusicChangeRequest) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| `changeRequests[]` | `object (`[MusicChangeRequest](/youtube/partner/reference/rest/v1/musicChangeRequests#MusicChangeRequest)`)` The requested music change requests. |\n| `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. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/youtubepartner`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2).\n\nChangeRequestFilter\n-------------------\n\nRepresentation of an expression for filtering in musicChangeRequests.list. We always take the conjunction (logical AND) of the filters, so a changeRequest must meet all criteria to be returned.\n\n| JSON representation |\n|------------------------------|\n| ``` { \"parent\": string } ``` |\n\n| Fields ||\n|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent of the change request. Could be a release or a track. Format: releases/{release} or releases/{release}/tracks/{track} |"]]
