En esta referencia de la API, se explica cómo programar transmisiones en vivo y transmisiones de video en YouTube con la API de YouTube Live Streaming.
Tipos de recursos
LiveBroadcasts
Un recurso liveBroadcast
representa un evento que se transmitirá en vivo por video en YouTube.
Consulta la representación y la lista de propiedades de este recurso para obtener más información.
Método | Solicitud HTTP | Descripción |
---|---|---|
URIs relativos a https://www.googleapis.com/youtube/v3 |
||
bind |
POST /liveBroadcasts/bind |
Vincula una transmisión de YouTube a un flujo o quita una vinculación existente entre una transmisión y un flujo. Una transmisión solo se puede vincular a una transmisión de video por Internet, aunque una transmisión de video por Internet se puede vincular a más de una transmisión. |
delete |
DELETE /liveBroadcasts |
Borra una transmisión. |
insert |
POST /liveBroadcasts |
Crea una transmisión. |
list |
GET /liveBroadcasts |
Devuelve una lista de las transmisiones de YouTube que coinciden con los parámetros de la solicitud de la API. |
transition |
POST /liveBroadcasts/transition |
Cambia el estado de una transmisión en vivo de YouTube y, luego, inicia los procesos asociados con el nuevo estado. Por ejemplo, cuando cambias el estado de una transmisión a testing , YouTube comienza a transmitir video al flujo de supervisión de esa transmisión. Antes de llamar a este método, debes confirmar que el valor de la propiedad status.streamStatus para la transmisión vinculada a tu emisión sea active . |
update |
PUT /liveBroadcasts |
Actualiza una transmisión. Por ejemplo, podrías modificar la configuración de transmisión definida en el objeto contentDetails del recurso liveBroadcast . |
cuepoint |
POST /liveBroadcasts/cuepoint |
Inserta un punto de referencia en una transmisión en vivo. Es posible que el punto de referencia active una pausa publicitaria. |
LiveChatBans
Un recurso liveChatBan
identifica a un usuario de YouTube y un chat en vivo de YouTube en el que se le prohibió participar.
Consulta la representación y la lista de propiedades de este recurso para obtener más información.
Método | Solicitud HTTP | Descripción |
---|---|---|
URIs relativos a https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /liveChat/bans |
Quita una prohibición que impide que un usuario específico contribuya a un chat en vivo, lo que permite que el usuario vuelva a unirse al chat. El propietario del canal o un moderador del chat en vivo asociado con la prohibición deben autorizar la solicitud a la API. |
insert |
POST /liveChat/bans |
Prohíbe a un usuario específico participar en el chat en vivo. El propietario del canal o un moderador del chat en vivo asociado con la prohibición deben autorizar la solicitud a la API. |
LiveChatMessages
Un recurso liveChatMessage
representa un mensaje de chat en un chat en vivo de YouTube. El recurso puede contener detalles sobre varios tipos de mensajes, como un mensaje de texto publicado recientemente o un evento de financiación de fans.
La función de chat en vivo está habilitada de forma predeterminada para las transmisiones en vivo y está disponible mientras el evento en vivo está activo. (Después de que finalice el evento, el chat en vivo ya no estará disponible).
Consulta la representación y la lista de propiedades de este recurso para obtener más información.
Método | Solicitud HTTP | Descripción |
---|---|---|
URIs relativos a https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /liveChat/messages |
Borra un mensaje de chat. El propietario del canal o un moderador del chat en vivo asociado con la prohibición deben autorizar la solicitud a la API. |
insert |
POST /liveChat/messages |
Agrega un mensaje a un chat en vivo. |
list |
GET /liveChat/messages |
Enumera los mensajes del chat en vivo de un chat específico. |
streamList |
Demostración de código | Habilita una conexión de transmisión desde el servidor para recibir mensajes de chat en vivo de un chat específico con baja latencia. |
LiveChatModerators
Un recurso liveChatModerator
representa a un moderador de un chat en vivo de YouTube. Un moderador del chat puede prohibir o levantar la prohibición de usuarios en un chat, quitar mensajes y realizar otras acciones administrativas en el chat en vivo.
Consulta la representación y la lista de propiedades de este recurso para obtener más información.
Método | Solicitud HTTP | Descripción |
---|---|---|
URIs relativos a https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /liveChat/moderators |
Quita a un moderador del chat. El propietario del canal de la transmisión en vivo debe autorizar la solicitud. |
insert |
POST /liveChat/moderators |
Agrega un moderador nuevo al chat. El propietario del canal de la transmisión en vivo debe autorizar la solicitud. |
list |
GET /liveChat/moderators |
Enumera los moderadores de un chat en vivo. El propietario del canal de la transmisión en vivo debe autorizar la solicitud. |
LiveStreams
Un recurso liveStream
contiene información sobre la transmisión de video que envías a YouTube. La transmisión proporciona el contenido que se emitirá para los usuarios de YouTube. Una vez creado, un recurso liveStream
se puede vincular a uno o más recursos liveBroadcast
.
Consulta la representación y la lista de propiedades de este recurso para obtener más información.
Método | Solicitud HTTP | Descripción |
---|---|---|
URIs relativos a https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /liveStreams |
Borra una transmisión de video por Internet. |
insert |
POST /liveStreams |
Crea una transmisión de video. La transmisión te permite enviar tu video a YouTube, que luego puede transmitirlo a tu público. |
list |
GET /liveStreams |
Devuelve una lista de transmisiones de video que coinciden con los parámetros de la solicitud de la API. |
update |
PUT /liveStreams |
Actualiza una transmisión de video. Si no se pueden actualizar las propiedades que deseas cambiar, debes crear un flujo nuevo con la configuración adecuada. |
SuperChatEvents
Un recurso superChatEvent
representa un mensaje de Súper chat que compró un fan durante una transmisión en vivo de YouTube. En el chat en vivo de YouTube, los Súper chats se destacan de los demás mensajes de las siguientes maneras:
- Los Súper chats se destacan con un color.
- Los Súper chats permanecen fijos en el visor por un período establecido.
El color del Súper chat, el período durante el que permanece fijado en el visor y la longitud máxima del mensaje se determinan según el importe de la compra. Consulta el Centro de ayuda de YouTube para obtener más información sobre los Súper chats.
Consulta la representación y la lista de propiedades de este recurso para obtener más información.
Método | Solicitud HTTP | Descripción |
---|---|---|
URIs relativos a https://www.googleapis.com/youtube/v3 |
||
list |
GET /superChatEvents |
Enumera los eventos de Súper chat de las transmisiones en vivo de un canal de los últimos 30 días. |
Tipos de recursos obsoletos
FanFundingEvents
Un recurso fanFundingEvent
representa un evento de financiación de fans en un canal de YouTube. La financiación de fans es una forma de apoyar económicamente a los creadores de YouTube. Un evento de Financiación de fans ocurre cuando un usuario realiza un pago voluntario único a un canal. Consulta el Centro de ayuda de YouTube para obtener más información sobre la Financiación de fans.
Consulta la representación y la lista de propiedades de este recurso para obtener más información.
Método | Solicitud HTTP | Descripción |
---|---|---|
URIs relativos a https://www.googleapis.com/youtube/v3 |
||
list |
GET /fanFundingEvents |
Enumera los eventos de financiación de fans de un canal. El propietario del canal debe autorizar la solicitud a la API. |
LiveCuepoints
Un recurso liveCuepoint
inicia una pausa publicitaria en la transmisión de video.
Nota: El comando de la API para controlar los puntos de referencia en realidad forma parte de la API de Content ID de YouTube y tiene requisitos de autorización diferentes a los de las solicitudes para administrar los recursos liveBroadcast
y liveStream
.
Consulta la representación y la lista de propiedades de este recurso para obtener más información.
Método | Solicitud HTTP | Descripción |
---|---|---|
URIs relativos a https://www.googleapis.com/ |
||
insert |
POST /liveCuepoints |
Inserta un punto de referencia en una transmisión en vivo. Actualmente, las solicitudes a este método deben estar autorizadas por una cuenta asociada a un propietario de contenido de YouTube. |
Patrocinadores
Un recurso sponsor
representa a un patrocinador de un canal de YouTube. Un patrocinador le brinda apoyo económico recurrente, como una tarifa de suscripción o membresía, a un creador y recibe beneficios especiales. Por ejemplo, los patrocinadores pueden chatear cuando el creador activa el modo exclusivo para patrocinadores en un chat.
Consulta la representación y la lista de propiedades de este recurso para obtener más información.
Método | Solicitud HTTP | Descripción |
---|---|---|
URIs relativos a https://www.googleapis.com/youtube/v3 |
||
list |
GET /sponsors |
Enumera los patrocinadores de un canal. El propietario del canal debe autorizar la solicitud a la API. |