Captions: insert

Загружает дорожку субтитров.

Этот метод поддерживает загрузку медиафайлов. Загружаемые файлы должны соответствовать следующим требованиям:

  • Максимальный размер файла: 100 МБ.
  • Допустимые MIME-типы медиаконтента: text/xml, application/octet-stream, */*.

Влияние на квоту. Вызов этого метода сокращает квоту на 400 единиц.

Примеры использования

Запрос

HTTP-запрос

POST https://www.googleapis.com/upload/youtube/v3/captions

Авторизация

Для этого запроса требуется авторизация по крайней мере с одной из следующих областей действия. Подробнее об аутентификации и авторизации читайте в статье Реализация авторизации OAuth 2.0.

Область действия
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

Параметры

В таблице ниже перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.

Параметры
Обязательные параметры
part string
Параметр part указывает, какие части ресурса caption будут включены в ответ API. Задайте значение параметра snippet.

В списке ниже приведены названия part, которые можно включить в значение параметра:
  • id
  • snippet
Необязательные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в авторизованном запросе.

Примечание. Этот параметр предназначен исключительно для партнеров YouTube.

Параметр onBehalfOfContentOwner указывает, что авторизационные данные запроса идентифицируют пользователя системы управления контентом YouTube, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для партнеров YouTube, которые владеют несколькими каналами и управляют ими. Владельцы контента могут пройти аутентификацию один раз и получить доступ к данным всех своих видео и каналов. Аккаунт CMS, с помощью которого пользователь проходит аутентификацию, должен быть связан с указанным владельцем контента YouTube.
sync boolean
Этот параметр больше не поддерживается. Параметр sync указывает, нужно ли YouTube автоматически синхронизировать файл субтитров с аудиодорожкой видео. Если вы зададите значение true, YouTube проигнорирует все временные коды в загруженном файле субтитров и создаст новые.

Параметр sync следует установить в значение true, если вы загружаете расшифровку без временных кодов или подозреваете, что временные коды в вашем файле неверны и хотите, чтобы YouTube попытался их исправить.

Тело запроса

Укажите ресурс caption в теле запроса. Для этого ресурса:

Необходимо указать значение для следующих свойств:

  • snippet.videoId
  • snippet.language
  • snippet.name

Вы можете задать значения для следующих свойств:

  • snippet.videoId
  • snippet.language
  • snippet.name
  • snippet.isDraft

Ответ

Если запрос выполнен успешно, этот метод возвращает ресурс caption в теле ответа.

Ошибки

В таблице ниже перечислены сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Подробнее об ошибках YouTube Data API…

Тип ошибки Сведения об ошибке Описание
badRequest (400) contentRequired Запрос не содержит дорожку субтитров.
conflict (409) captionExists В указанном видео уже есть дорожка субтитров с заданными значениями snippet.language и snippet.name. У видео может быть несколько дорожек на одном языке, но у каждой должно быть уникальное название.

Эту ошибку можно исправить несколькими способами. Вы можете удалить существующую дорожку, а затем вставить новую или изменить название новой дорожки перед вставкой.
forbidden (403) forbidden У разрешений, связанных с запросом, недостаточно прав для загрузки дорожки субтитров. Возможно, запрос не был авторизован должным образом.
invalidValue (400) invalidMetadata Запрос содержит недопустимые значения метаданных, которые не позволяют создать трек. Убедитесь, что в запросе указаны допустимые значения свойств snippet.language, snippet.name и snippet.videoId. Свойство snippet.isDraft также можно добавить, но это не обязательно.
notFound (404) videoNotFound Не удалось найти видео, указанное в параметре videoId.
invalidValue (400) nameTooLong Значение snippet.name, указанное в запросе, слишком длинное. Максимальная длина – 150 символов.

Попробовать

Используйте APIs Explorer, чтобы вызвать этот API и посмотреть запрос к API и ответ.