注意：YouTube Data API 仅供 YouTube 内容合作伙伴使用，并非所有开发者或 YouTube 用户都可以访问。您需要拥有 YouTube 内容管理器账号才能访问。如果您拥有 YouTube Content Manager 账号，但未在 Google Cloud 控制台中看到 YouTube Data API 列为服务之一，请与您的指定合作伙伴经理或合作伙伴支持团队联系。
注意：本指南中的信息专门适用于组合素材资源。
在 YouTube 工作室中，您可以请求更改您拥有的音乐资产。您还可以使用 Content ID API 执行以下操作：
- 创建变更请求
- 列出变更请求的状态
本页面简要介绍了 Content ID API 中的 MusicChangeRequest 方法。此外，还提供了有关如何创建和列出更改请求的示例。
要求
您需要获取授权凭据才能使用此 API。您将在请求中使用授权令牌。如果您使用的是 cURL，请务必创建一个 AUTH_TOKEN 变量以供这些命令使用：
export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"
创建音乐变更请求
您可以使用 musicChangeRequests.create 方法更改发行作品或曲目。您的请求需要包含一个更改请求资源，用于指定您要进行的更改类型。然后，您可以列出变更请求以查看其状态。
变更请求类型
有效的请求类型包括：
misreconciledArtist：请求更改发行作品或曲目的音乐人。接受DesiredArtist资源。如果 Art Track 未与所需的主要音乐人或合作音乐人相关联，请使用此选项。undesiredDiscography：请求更改与发行作品关联的音乐人频道。如果其他音乐人的发行作品错误地出现在了某个音乐人频道上，请使用此选项。incorrectPlayability：请求更改发行作品或曲目的可播放性。如果发行作品无法在资产中正常播放或显示，请使用此选项。incorrectMusicVideo：请求更改曲目的 MV。接受DesiredMusicVideo资源。如果 Art Track 未与所需 MV 相关联，请使用此选项。incorrectMetadata：请求更改发行作品或曲目的拼写、格式或翻译。
示例：发行作品未与所需的主要音乐人或合作音乐人相关联
假设您向 YouTube Music 提交了一部作品，但该作品关联的音乐人信息有误。如需请求进行此更改，请执行以下操作：
-
在 YouTube 工作室中找到受影响的版本。从 YouTube 工作室页面复制 ID 编号（例如 UPC）。
-
创建一个包含以下 JSON 语句的请求：
'{ "release": "releases/0012345678901", "misreconciledArtist": { "channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": false, "supplementalInfo": "Comment about the change" } }'release是发行作品的 ID 编号，您可以在 YouTube 工作室中找到该编号。misreconciledArtist接受由以下内容组成的desiredArtist资源：channelId：您要将发行作品转移到的艺术家的频道 ID。您可以在 YouTube 上访问音乐人的频道，然后从网址中复制频道 ID。如果音乐人不存在且是新音乐人，请将channelId留空，并标记newArtist: true。newArtist：如果音乐人目前不在 YouTube Music 上，请将此字段标记为true。否则，如果您提供了频道 ID，请将此字段标记为false。supplementalInfo：有关请求的可选注释。
-
使用
musicChangeRequests.create方法发出请求。包含请求的 JSON。例如，以下命令展示了如何使用 cURL 发出此请求：curl -v -H "Authorization: Bearer $AUTH_TOKEN" --json '{"release": "releases/0012345678901", "misreconciledArtist": {"channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": "false", "supplementalInfo": "Comment about the change"}}' https://www.googleapis.com/youtube/partner/v1/music/changeRequests
列出更改请求
如需检索已报告的音乐更改请求的列表，请使用 musicChangeRequests.list 方法。该方法会返回按内容所有者过滤的更改请求列表。您还可以按发行作品或轨道以及内容所有者过滤结果。
示例：列出特定版本的变更请求
假设您需要获取与另一位内容所有者针对特定发布版本提出的更改请求。以下命令展示了如何使用 cURL 发出此请求：
curl -v -H "Authorization: Bearer $AUTH_TOKEN" https://www.googleapis.com/youtube/partner/v1/music/changeRequests?onBehalfOfContentOwner=91U_FgOL8S7d52aNESfMaw&filter.parent=releases/0999999999999
其中：
onBehalfOfContentOwner是拥有相应专辑或曲目的内容所有者的频道 ID。filter指定release/[RELEASE_ID_NUMBER]或track/[TRACK_ID_NUMBER]。