Примечание. API Content ID YouTube предназначен для использования контент-партнерами YouTube и доступен не всем разработчикам и не всем пользователям YouTube. Если вы не видите API Content ID YouTube в качестве одной из служб, перечисленных в консоли Google API , посетите Справочный центр 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]
.