此页面由 Cloud Translation API 翻译。

管理音乐更改请求

注意：YouTube Content ID API 专供 YouTube 内容合作伙伴使用，并非所有开发者或 YouTube 用户都能使用。如果您在 Google API 控制台中未看到 YouTube Content ID API 列为某项服务，请访问 YouTube 帮助中心，详细了解 YouTube 合作伙伴计划。

注意：本指南中的信息仅适用于乐曲资产。

在 YouTube 工作室中，您可以请求更改您拥有的音乐资产。您还可以使用 Content ID API 执行以下操作：

创建更改请求
列出更改请求的状态

本页面简要介绍了 Content ID API 中的 MusicChangeRequest 方法。此外，本页面还提供了有关如何创建和列出更改请求的示例。

要求

您需要获取授权凭据才能使用此 API。您需要在请求中使用授权令牌。

如果您使用的是 c网址，请务必创建要在以下命令中使用的 AUTH_TOKEN 变量：

export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"

创建音乐更改请求

您可以使用 musicChangeRequests.create 方法更改发布版本或轨道。您的请求必须包含更改请求资源，用于指定您要做出的更改类型。然后，您可以列出您的更改请求以检查其状态。

更改请求的类型

有效的请求类型包括：

misreconciledArtist：请求更改专辑或曲目的音乐人。接受 DesiredArtist 资源。如果频道未与所需的主要或主打音乐人相关联，请使用此选项。
undesiredDiscography：请求更改与专辑关联的音乐人频道。如果其他音乐人的专辑错误地出现在音乐人的频道中，请使用此选项。
incorrectPlayability：请求更改专辑或曲目的可玩性。如果视频无法按预期在产品中播放或显示，请使用此选项。
incorrectMusicVideo：请求更改曲目的音乐视频。接受 DesiredMusicVideo 资源。如果此选项未与所需音乐视频相关联，请使用此选项。
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。要获取频道 ID，您可以访问音乐人在 YouTube 上的频道，然后从相应网址复制该 ID。如果音乐人不存在，但是新音乐人，请将 channelId 留空，并标记 newArtist: true。
  - newArtist：如果音乐人当前不在 YouTube Music 中，请将此字段标记为 true。否则，如果您提供了频道 ID，请将此字段标记为 false。
  - supplementalInfo：关于请求的可选备注。

使用 musicChangeRequests.create 方法发出请求。添加包含请求的 JSON。例如，以下命令展示了如何使用 c网址发出此请求：

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 方法。该方法会返回一份更改请求列表作为响应，该列表按内容所有者过滤。您还可以按发行或曲目以及内容所有者来过滤结果。

示例：列出特定版本的更改请求

假设您需要获得另一位内容所有者对特定发布内容的更改请求。以下命令示例展示了如何使用 c网址发出此请求：

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]。