LiveStreams: update

Обновляет видеопоток. Если свойства, которые вы хотите изменить, не могут быть обновлены, вам необходимо создать новый поток с соответствующими настройками.

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

Запрос

HTTP-запрос 

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

Авторизация

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

Объем
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Параметры

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

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

Свойства part , которые вы можете включить в значение параметра, — это id , snippet , cdn и status .

Обратите внимание, что этот метод переопределяет существующие значения для всех изменяемых свойств, содержащихся в любых частях, указанных в значении параметра. Если в тексте запроса не указано значение изменяемого свойства, существующее значение этого свойства будет удалено.
Дополнительные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в должным образом авторизованном запросе .

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

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

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

Тело запроса

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

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

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

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

    • snippet.title
    • snippet.description

    Если вы отправляете запрос на обновление и в вашем запросе не указано значение свойства, которое уже имеет значение, существующее значение свойства будет удалено.

Ответ

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

Ошибки

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

Тип ошибки Детализация ошибки Описание
forbidden (403) liveStreamModificationNotAllowed Указанный прямой эфир не может быть изменен в его текущем состоянии. Для получения дополнительной информации см. Жизнь трансляции .
forbidden (403) liveStreamModificationNotAllowed API не позволяет изменять значения полей cdn.format , cdn.frameRate , cdn.ingestionType или cdn.resolution после создания потока.
forbidden (403) liveStreamModificationNotAllowed API не позволяет вам изменить повторно используемый поток на неповторно используемый и наоборот. Дополнительные сведения см. в разделе Общие сведения о широковещательных рассылках и потоках .
insufficientPermissions insufficientLivePermissions Запросу не разрешено обновлять указанный прямой эфир. Дополнительные сведения см. в разделе «Реализация аутентификации OAuth2» .
insufficientPermissions liveStreamingNotEnabled Пользователь, авторизовавший запрос, не имеет права транслировать видео в реальном времени на YouTube. Пользователь может найти дополнительную информацию в разделе «Приемлемость функций» .
invalidValue (400) invalidDescription Значение свойства snippet.description в ресурсе liveStream может содержать до 10 000 символов.
invalidValue (400) invalidTitle Значение свойства snippet.title в ресурсе liveStream должно иметь длину от 1 до 128 символов.
notFound (404) liveStreamNotFound Указанная прямая трансляция не существует.
required (400) idRequired Ресурс liveStream должен указать значение свойства id .
required (400) ingestionTypeRequired Ресурс liveStream должен указать значение свойства cdn.ingestionType .
required (400) titleRequired Ресурс liveStream должен указать значение свойства snippet.title .

Попробуйте!

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.