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, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для партнеров 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 может возвращать в ответ на вызов этого метода. Подробнее об ошибках YouTube Live Streaming API…

Тип ошибки	Сведения об ошибке	Описание
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 и ответ.