Captions: insert

Загружает субтитры.

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

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

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

Распространенные случаи использования

Запрос

HTTP-запрос

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

Авторизация

Этот запрос требует авторизации хотя бы в одной из следующих областей ( подробнее об аутентификации и авторизации читайте здесь ).

Объем
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 CMS, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для контент-партнеров YouTube, которые владеют и управляют множеством различных каналов YouTube. Это позволяет владельцам контента один раз пройти аутентификацию и получить доступ ко всем своим видео и данным каналов без необходимости предоставлять учетные данные аутентификации для каждого отдельного канала. Фактическая учетная запись CMS, с помощью которой пользователь проходит аутентификацию, должна быть связана с указанным владельцем контента YouTube.
sync boolean
Этот параметр устарел. Параметр sync указывает, должен ли YouTube автоматически синхронизировать файл субтитров со звуковой дорожкой видео. Если вы установите значение true , YouTube будет игнорировать все тайм-коды, содержащиеся в загруженном файле подписей, и будет генерировать для подписей новые тайм-коды.

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

Тело запроса

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

  • Вы должны указать значение для этих свойств:

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

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

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

Ответ

В случае успеха этот метод возвращает ресурс подписи в теле ответа.

Ошибки

В следующей таблице указаны сообщения об ошибках, которые 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.

,

Загружает субтитры.

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

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

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

Распространенные случаи использования

Запрос

HTTP-запрос

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

Авторизация

Этот запрос требует авторизации хотя бы в одной из следующих областей ( подробнее об аутентификации и авторизации читайте здесь ).

Объем
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 CMS, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для контент-партнеров YouTube, которые владеют и управляют множеством различных каналов YouTube. Это позволяет владельцам контента один раз пройти аутентификацию и получить доступ ко всем своим видео и данным каналов без необходимости предоставлять учетные данные аутентификации для каждого отдельного канала. Фактическая учетная запись CMS, с помощью которой пользователь проходит аутентификацию, должна быть связана с указанным владельцем контента YouTube.
sync boolean
Этот параметр устарел. Параметр sync указывает, должен ли YouTube автоматически синхронизировать файл субтитров со звуковой дорожкой видео. Если вы установите значение true , YouTube будет игнорировать все тайм-коды, содержащиеся в загруженном файле подписей, и будет генерировать для подписей новые тайм-коды.

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

Тело запроса

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

  • Вы должны указать значение для этих свойств:

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

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

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

Ответ

В случае успеха этот метод возвращает ресурс подписи в теле ответа.

Ошибки

В следующей таблице указаны сообщения об ошибках, которые 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.