本頁面由 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。您會在要求中使用授權權杖。

如果您使用 cURL，請務必建立要在這些指令中使用的 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。例如，以下指令顯示如何使用 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]。