Referencia de la API

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.