Эта страница переведена с помощью Cloud Translation API.

Управление запросами на изменение музыки

Примечание. API Content ID YouTube предназначен для использования контент-партнерами YouTube и доступен не всем разработчикам и не всем пользователям YouTube. Если вы не видите API Content ID YouTube в качестве одной из служб, перечисленных в консоли API Google , посетите Справочный центр YouTube , чтобы узнать больше о Партнерской программе YouTube.

Примечание. Информация в этом руководстве относится конкретно к композиционным активам.

В Студии YouTube вы можете запросить изменения в принадлежащих вам музыкальных ресурсах . Вы также можете использовать Content ID API, чтобы:

Создание запросов на изменение
Список статусов запросов на изменение

На этой странице представлен обзор методов MusicChangeRequest в Content ID API. В нем также приведены примеры того, как создавать и перечислять запросы на изменения.

Требования

Для использования этого API вам необходимо получить учетные данные авторизации . Вы будете использовать свой токен авторизации в своих запросах.

Если вы используете cURL, обязательно создайте переменную AUTH_TOKEN для использования в этих командах:

export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"

Создать запрос на изменение музыки

Вы используете метод musicChangeRequests.create для изменения релиза или трека. Ваш запрос должен включать ресурс запроса на изменение , который указывает тип изменения, которое вы хотите внести. Затем вы можете перечислить свои запросы на изменения , чтобы проверить их статус.

Типы запросов на изменение

Допустимые типы запросов включают в себя:

misreconciledArtist : запрос на смену исполнителя для релиза или трека. Принимает ресурс DesiredArtist . Используйте эту опцию, если она не связана с нужным основным или избранным исполнителем.
undesiredDiscography : запрос на изменение канала исполнителя, связанного с релизом. Используйте эту опцию, если релиз другого исполнителя неправильно отображается на его канале.
incorrectPlayability : запрос на изменение возможности воспроизведения релиза или трека. Используйте эту опцию, если она не воспроизводится или не отображается должным образом в продукте.
incorrectMusicVideo : запрос на изменение музыкального видео трека. Принимает ресурс DesiredMusicVideo . Используйте эту опцию, если она не связана с нужным музыкальным видео.
incorrectMetadata : запрос на изменение написания, форматирования или перевода релиза или трека.

Пример. Релиз не связан с желаемым основным или избранным исполнителем.

Предположим, вы отправили релиз на YouTube Music, но с ним связан неправильный исполнитель. Чтобы сделать запрос на это изменение:

Найдите затронутую версию в Студии YouTube. Скопируйте идентификационный номер (например, UPC) со страницы Студии YouTube.
Создайте запрос, содержащий следующий оператор JSON:
```
'{
  "release": "releases/0012345678901", 
  "misreconciledArtist": {
    "channelId": "UCP8W_Atlibtp488XGcRkPnQ", 
    "newArtist": "false", 
    "supplementalInfo": "Comment about the change"
  }
}'
```
- release — это идентификационный номер выпуска, который можно найти в Студии YouTube.
- misreconciledArtist принимает ресурс desiredArtist , состоящий из следующего:
  - channelId : идентификатор канала исполнителя, которому вы хотите передать релиз. Вы можете получить идентификатор канала, посетив канал исполнителя на YouTube и скопировав идентификатор из URL-адреса. Если исполнитель не существует и является новым исполнителем, оставьте channelId пустым и отметьте newArtist: true .
  - newArtist : если исполнителя в настоящее время нет на YouTube Music, отметьте это поле true . В противном случае, если вы указали идентификатор канала, отметьте это поле значением 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 — это идентификатор канала владельца контента, которому принадлежит выпуск или трек.
filter указывает release/[RELEASE_ID_NUMBER] или track/[TRACK_ID_NUMBER] .