Method: musicChangeRequests.list

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
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
}
Fields
parent

string

Required. The parent of the change request. Could be a release or a track. Format: releases/{release} or releases/{release}/tracks/{track}