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 указывает, что учетные данные авторизации запроса идентифицируют пользователя CMS YouTube, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для контент-партнеров 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.