LiveStreams: insert

Создает видеопоток. Поток позволяет отправлять видео на YouTube, откуда оно транслируется зрителям.

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

Запрос

HTTP-запрос

POST https://www.googleapis.com/youtube/v3/liveStreams

Авторизация

Для выполнения этого запроса требуется авторизация как минимум в одной из следующих областей доступа. Подробнее…

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

Параметры

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

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

Свойства part, которые можно включить в значение параметра: id, snippet, cdn, contentDetails и status.
Необязательные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в авторизованном запросе. Примечание. Этот параметр предназначен исключительно для партнеров YouTube по контенту.

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

Параметр onBehalfOfContentOwnerChannel указывает идентификатор канала YouTube, на который добавляется видео. Этот параметр обязателен, если в запросе указано значение параметра onBehalfOfContentOwner, и может использоваться только вместе с ним. Кроме того, запрос должен быть авторизован с помощью аккаунта CMS, связанного с владельцем контента, который указан в параметре onBehalfOfContentOwner. Канал, указанный в значении параметра onBehalfOfContentOwnerChannel, должен быть связан с владельцем контента, указанным в параметре onBehalfOfContentOwner.

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

Тело запроса

В теле запроса укажите ресурс liveStream. Для этого ресурса:

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

    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

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

    • snippet.title
    • snippet.description
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution
    • contentDetails.isReusable

Ответ

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

Ошибки

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

Тип ошибки Сведения об ошибке Описание
insufficientPermissions insufficientLivePermissions У запроса нет разрешения на создание указанной трансляции.
insufficientPermissions livePermissionBlocked Пользователь, авторизовавший запрос, в настоящее время не может проводить трансляции на YouTube. Подробную информацию о том, почему пользователь не может проводить трансляции, можно найти в настройках канала на странице https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled Пользователь, авторизовавший запрос, не может проводить прямые трансляции на YouTube. Подробную информацию можно найти на странице https://www.youtube.com/features.
invalidValue (400) invalidDescription Значение свойства snippet.description в ресурсе liveStream может содержать до 10 000 символов.
invalidValue (400) invalidFormat Значение свойства cdn.format в ресурсе liveStream недопустимо.
invalidValue (400) invalidFrameRate Недопустимое значение свойства cdn.frameRate в ресурсе liveStream.
invalidValue (400) invalidIngestionType Недопустимое значение свойства cdn.ingestionType в ресурсе liveStream.
invalidValue (400) invalidResolution Недопустимое значение свойства cdn.resolution в ресурсе liveStream.
invalidValue (400) invalidTitle Значение свойства snippet.title в ресурсе liveStream должно содержать от 1 до 128 символов.
rateLimitExceeded userRequestsExceedRateLimit Пользователь отправил слишком много запросов за определенный период времени.
required (400) cdnRequired Ресурс liveStream должен содержать объект cdn.
required (400) frameRateRequired API возвращает эту ошибку, если вы указали значение для свойства cdn.resolution, но не указали значение для свойства cdn.frameRate.
required (400) ingestionTypeRequired В ресурсе liveStream должно быть указано значение свойства cdn.ingestionType.
required (400) resolutionRequired API возвращает эту ошибку, если вы указали значение для свойства cdn.frameRate, но не для свойства cdn.resolution.
required (400) titleRequired В ресурсе liveStream должно быть указано значение свойства snippet.title.

Попробовать

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