Method: musicChangeRequests.list

Page Summary

This API endpoint retrieves a list of music change requests related to a specific release or track via a GET request to the provided URL.
You can filter the results using various parameters, such as pageSize , pageToken , onBehalfOfContentOwner , and filter , allowing for customized data retrieval.
The response contains an array of changeRequests , which represent the music change requests, and a nextPageToken for accessing subsequent pages of results.
Authorization to use this endpoint requires the https://www.googleapis.com/auth/youtubepartner OAuth scope.
The ChangeRequestFilter object allows for filtering change requests based on the parent release or track.

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

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:

JSON representation
{ "changeRequests" : [ { object ( `MusicChangeRequest` ) } ] , "nextPageToken" : string }

Fields

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.

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.

JSON representation
{ "parent" : string }