Обновляет видеопоток. Если свойства, которые вы хотите изменить, не могут быть обновлены, вам необходимо создать новый поток с соответствующими настройками.
Общие варианты использования
Запрос
HTTP-запрос
PUT 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 и status .Обратите внимание, что этот метод переопределит существующие значения для всех изменяемых свойств, которые содержатся в любых частях, указанных в значении параметра. Если в тексте запроса не указано значение изменяемого свойства, существующее значение этого свойства будет удалено. | |
Дополнительные параметры | ||
onBehalfOfContentOwner | string Этот параметр можно использовать только в правильно авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube. Параметр onBehalfOfContentOwner указывает, что учетные данные авторизации запроса идентифицируют пользователя CMS YouTube, который действует от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для контент-партнеров 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 может возвращать в ответ на вызов этого метода. Более подробную информацию см. в документации по сообщениям об ошибках .
Тип ошибки | Сведения об ошибке | Описание |
---|---|---|
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. Пользователь может найти дополнительную информацию на странице https://www.youtube.com/features . |
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.