LiveBroadcasts: insert

Теперь API позволяет отмечать прямые трансляции как предназначенные для детей. Ресурс liveBroadcast теперь содержит свойство, которое определяет статус трансляции. Условия использования сервисов YouTube API и правила для разработчиков также были обновлены 10 января 2020 года. Подробную информацию вы найдете в истории изменений YouTube Live Streaming API Service и Условий использования сервисов YouTube API.

Создает трансляцию.

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

Запрос

HTTP-запрос

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

Авторизация

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

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

Параметры

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

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

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

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

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

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

Тело запроса

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

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

    • snippet.title
    • snippet.scheduledStartTime
    • status.privacyStatus

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

    • snippet.title
    • snippet.description
    • snippet.categoryId
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • status.selfDeclaredMadeForKids
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.availabilityConfig
    Примечание. В таблице свойств указаны значения по умолчанию для перечисленных свойств. Значения по умолчанию будут назначены в следующих случаях:
    • Значения для этих свойств указывать не нужно.
    • Значение параметра part в запросе не указывает на часть, содержащую эти свойства.

Ответ

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

Ошибки

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

Тип ошибки Сведения об ошибке Описание
insufficientPermissions insufficientLivePermissions У вас нет разрешения на создание прямой трансляции.
insufficientPermissions livePermissionBlocked Пользователь, авторизовавший запрос, в настоящее время не может проводить трансляции на YouTube. Подробную информацию о том, почему пользователь не может проводить трансляции, можно найти в настройках канала на странице https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled У пользователя, который авторизовал запрос, нет разрешения на проведение трансляций на YouTube. Подробную информацию можно найти на странице https://www.youtube.com/features.
invalidValue (400) invalidAutoStart Ресурс liveBroadcast содержит недопустимое значение свойства contentDetails.enableAutoStart. Эта настройка доступна не для всех трансляций.
invalidValue (400) invalidAutoStop Ресурс liveBroadcast содержит недопустимое значение свойства contentDetails.enableAutoStop. Вы не можете изменить настройку enableAutoStop для постоянной трансляции.
invalidValue (400) invalidDescription В ресурсе liveBroadcast не указано действительное значение свойства snippet.description. Значение свойства может содержать до 5000 символов.
invalidValue (400) invalidEmbedSetting Ресурс liveBroadcast содержит недопустимое значение для свойства contentDetails.enable_embed. Эту трансляцию нельзя встроить.
invalidValue (400) invalidLatencyPreferenceOptions Ресурс liveBroadcast содержит недопустимое значение свойства contentDetails.latencyPreference. Не все настройки поддерживаются при таком уровне задержки.
invalidValue (400) invalidPrivacyStatus Ресурс liveBroadcast содержит недопустимое значение для свойства status.privacy_status.
invalidValue (400) invalidProjection Ресурс liveBroadcast содержит недопустимое значение свойства contentDetails.projection. Для трансляции по умолчанию нельзя задать проекцию 360.
invalidValue (400) invalidScheduledEndTime Ресурс liveBroadcast содержит недопустимое значение для свойства snippet.scheduledEndTime. Время окончания должно быть позже времени начала.
invalidValue (400) invalidScheduledStartTime Ресурс liveBroadcast содержит недопустимое значение свойства snippet.scheduledStartTime. Время начала трансляции должно быть в будущем и достаточно близко к текущей дате, чтобы трансляцию можно было надежно запланировать на это время.
invalidValue (400) invalidTitle В ресурсе liveBroadcast не указано действительное значение свойства snippet.title. Значение свойства должно содержать от 1 до 100 символов.
limitExceeded userBroadcastsExceedLimit Пользователь создал слишком много трансляций или запланированных трансляций и должен остановить или удалить некоторые из них.
rateLimitExceeded userRequestsExceedRateLimit Пользователь отправил слишком много запросов за определенный период времени.
required (400) privacyStatusRequired В ресурсе liveBroadcast должен быть указан статус конфиденциальности. Ознакомьтесь с допустимыми значениями privacyStatus.
required (400) scheduledEndTimeRequired В ресурсе liveBroadcast должно быть указано свойство snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired В ресурсе liveBroadcast должно быть указано свойство snippet.scheduledStartTime.
required (400) titleRequired В ресурсе liveBroadcast должно быть указано свойство snippet.title.

Попробовать

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