LiveBroadcasts: bind

Связывает трансляцию на YouTube с потоком или удаляет существующую связь между трансляцией и потоком. Трансляция может быть связана только с одним видеопотоком, но видеопоток может быть связан с несколькими трансляциями.

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

Запрос

HTTP-запрос

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

Авторизация

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

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

Параметры

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

Параметры
Обязательные параметры
id string
Параметр id задает уникальный идентификатор трансляции, которая привязывается к видеопотоку.
part string
Параметр part задает список свойств ресурса liveBroadcast, разделенных запятыми, которые будут включены в ответ 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. Владельцы контента могут один раз пройти аутентификацию и выполнять действия от имени канала, указанного в значении параметра, не предоставляя учетные данные для каждого отдельного канала.
streamId string
Параметр streamId указывает уникальный идентификатор видеопотока, который связывается с трансляцией. Если этот параметр не указан, API удалит все существующие связи между трансляцией и видеопотоком.

Тело запроса

При вызове этого метода не указывайте тело запроса.

Ответ

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

Ошибки

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

Тип ошибки Сведения об ошибке Описание
backendError internalError При привязке произошла внутренняя ошибка.
forbidden (403) liveBroadcastBindingNotAllowed Текущий статус прямой трансляции не позволяет привязать ее к потоку.
insufficientPermissions insufficientLivePermissions У запроса нет разрешения на получение указанной прямой трансляции. Подробнее о реализации аутентификации OAuth2…
insufficientPermissions liveStreamingNotEnabled У пользователя, который авторизовал запрос, нет разрешения на проведение трансляций на YouTube. Подробную информацию можно найти на странице https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound Трансляция, указанная в параметре id, не существует.
notFound (404) liveStreamNotFound Поток, указанный в параметре streamId, не существует.
rateLimitExceeded userRequestsExceedRateLimit Пользователь отправил слишком много запросов за определенный период времени.
required (400) idRequired Обязательный параметр id должен идентифицировать трансляцию, которую нужно связать.

Попробовать

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