REST Resource: musicChangeRequests

  • The MusicChangeRequest resource represents a request for changes to music-related content, including details like creation time, type, and status.

  • Change requests can be associated with either a specific release or a track, and they cover various issues such as misreconciled artists, incorrect playability, undesired discography, or metadata errors.

  • The State of a MusicChangeRequest can be OPEN, CLOSED, or EXPIRED, indicating the status of the resolution process.

  • Several input-only data types contain supplemental information fields, for example DesiredArtist, UndesiredDiscography, IncorrectPlayability, DesiredMusicVideo and IncorrectMetadata, allowing partners to specify more details about their request.

  • Methods are provided to create new change requests or list existing ones, allowing for the managing of reported issues in music content.

Resource: MusicChangeRequest

A representation of a music change request.

JSON representation 
{
  "name": string,
  "createTime": string,
  "type": string,
  "state": enum (State),

  // Union field parent can be only one of the following:
  "release": string,
  "track": string
  // End of list of possible types for union field parent.

  // Union field details can be only one of the following:
  "misreconciledArtist": {
    object (DesiredArtist)
  },
  "undesiredDiscography": {
    object (UndesiredDiscography)
  },
  "incorrectPlayability": {
    object (IncorrectPlayability)
  },
  "incorrectMusicVideo": {
    object (DesiredMusicVideo)
  },
  "incorrectMetadata": {
    object (IncorrectMetadata)
  }
  // End of list of possible types for union field details.
}
Fields
name

string

Output only. Identifier. The resource name of the change request. Format: changeRequests/{changeRequest}
createTime

string (Timestamp format)

Output only. Creation time of the change request.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
type

string

Output only. Type of the change request. Possible values: misreconciledArtist, incorrectMetadata, incorrectArtists, undesiredReleaseDiscography, incorrectPlayability, incorrectTrackMusicVideo.
state

enum (State)

Output only. Status of the change request.
Union field parent. The parent of the change request that could be a release or a track. parent can be only one of the following:
release

string

Format: releases/{release}
track

string

Format: releases/{release}/tracks/{track}
Union field details. Input only. Detailed information about the ChangeRequest. details can be only one of the following:
misreconciledArtist

object (DesiredArtist)

Input only. Corresponds to the misreconciledArtist type.
undesiredDiscography

object (UndesiredDiscography)

Input only. Corresponds to the undesiredReleaseDiscography type.
incorrectPlayability

object (IncorrectPlayability)

Input only. Corresponds to the incorrectPlayability type.
incorrectMusicVideo

object (DesiredMusicVideo)

Input only. Corresponds to the incorrectTrackMusicVideo type.
incorrectMetadata

object (IncorrectMetadata)

Input only. Corresponds to the incorrectMetadata type.

State

Possible status values of change requests.

Enums
STATE_UNSPECIFIED Default value. This value is unused.
OPEN The change request is unresolved.
CLOSED An operator has closed the change request (perhaps without doing anything).
EXPIRED The change request has been closed without operator resolution.

DesiredArtist

The desired artist for reconciliation, as specified by a partner.

JSON representation 
{
  "channelId": string,
  "newArtist": boolean,
  "supplementalInfo": string
}
Fields
channelId

string

The channel ID of the desired artist.
newArtist

boolean

True iff there is no existing artist to associate with the release. channelId should be unset if this is true.
supplementalInfo

string

Generic supplemental information.

UndesiredDiscography

Corresponds to the 'Another artist's release is incorrectly appearing on my artist's channel' option.

JSON representation 
{
  "channelId": string,
  "undesiredPlaylistIds": [
    string
  ],
  "supplementalInfo": string
}
Fields
channelId

string

Channel ID of the artist with the undesired release discography.
undesiredPlaylistIds[]

string

Playlist IDs of the undesired releases.
supplementalInfo

string

Generic supplemental information.

IncorrectPlayability

Corresponds to the '(Release / Art track) is not playable or visible as expected in product' option.

JSON representation 
{
  "rightsTypes": [
    enum (ChangeRequestRightsType)
  ],
  "surfaces": [
    enum (ChangeRequestSurface)
  ],
  "territorySet": {
    object (TerritorySet)
  },
  "supplementalInfo": string
}
Fields
rightsTypes[]

enum (ChangeRequestRightsType)

The rights types to which the reported change request applies.
surfaces[]

enum (ChangeRequestSurface)

The surfaces to which the reported change request applies.
territorySet

object (TerritorySet)

The territories to which the reported change request applies.
supplementalInfo

string

Generic supplemental information.

ChangeRequestRightsType

The rights type affected by a reported change request.

Enums
CHANGE_REQUEST_RIGHTS_TYPE_UNSPECIFIED Default value. This value is unused.
AVOD Ad-based video on demand.
SVOD Subscription-based video on demand.

ChangeRequestSurface

The surface affected by a reported change request.

Enums
CHANGE_REQUEST_SURFACE_UNSPECIFIED Default value. This value is unused.
YOUTUBE_MUSIC YouTube Music App.
YOUTUBE YouTube Main.

TerritorySet

A collection of regions.

JSON representation 
{
  "everywhereComplement": boolean,
  "regionCodes": [
    string
  ]
}
Fields
everywhereComplement

boolean

If true, this forms the complement of the below set of regionCodes. Note that if this is true and regionCodes is empty it means everywhere.
regionCodes[]

string

List of regions with Unicode CLDR.

DesiredMusicVideo

The desired music video to associate with an Art Track, as specified by a partner.

JSON representation 
{
  "videoId": string,
  "noMusicVideo": boolean,
  "territorySet": {
    object (TerritorySet)
  },
  "supplementalInfo": string
}
Fields
videoId

string

The video ID of the desired music video to associate with the track.
noMusicVideo

boolean

True iff no music video should be associated with the track. videoId should be unset if this is true.
territorySet

object (TerritorySet)

The territories where this music video association should apply.
supplementalInfo

string

Generic supplemental information.

IncorrectMetadata

Corresponds to the '(Release / Art track) I delivered has incorrect spelling, formatting, or translation' and '(Release / Art track) I delivered has the wrong primary or featured artist' options.

JSON representation 
{
  "supplementalInfo": string
}
Fields
supplementalInfo

string

Generic supplemental information.

Methods

create

 Creates a music change request reported to a release or a track.

list

 Retrieves a list of music change requests reported to a release or a track.