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 relacionados con https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind Vincula una transmisión de YouTube a una transmisión o quita una vinculación existente entre una transmisión y una transmisión. Una transmisión solo se puede vincular a una transmisión de video, aunque una transmisión de video 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 Muestra una lista de transmisiones de YouTube que coinciden con los parámetros de 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 a la transmisión del monitor 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 transmisión sea active.
update PUT /liveBroadcasts Actualiza una transmisión. Por ejemplo, puedes modificar la configuración de transmisión definida en el objeto contentDetails del recurso liveBroadcast.
cuepoint POST /liveBroadcasts/cuepoint Inserta un punto de inserción en una transmisión en vivo. Es posible que el punto de inserción active una pausa publicitaria.

LiveChatBans

Un recurso liveChatBan identifica a un usuario de YouTube y un chat en vivo de YouTube en el que el usuario no puede 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 relacionados con https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Quita una prohibición que impide que un usuario específico participe en un chat en vivo, lo que le permite volver a unirse al chat. El propietario del canal o un moderador del chat en vivo asociado con la prohibición debe autorizar la solicitud a la API.
insert POST /liveChat/bans Impide que un usuario específico participe en el chat en vivo. El propietario del canal o un moderador del chat en vivo asociado con la prohibición debe 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 para ese evento).

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 relacionados con 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 debe autorizar la solicitud a la API.
insert POST /liveChat/messages Agrega un mensaje a un chat en vivo.
list GET /liveChat/messages Muestra una lista de los mensajes del chat en vivo de un chat específico.

LiveChatModerators

Un recurso liveChatModerator representa a un moderador de un chat en vivo de YouTube. Los moderadores de chat pueden prohibir o desbloquear usuarios de 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 relacionados con https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/moderators Quita a un moderador de 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 Muestra una lista de 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 transmitirá a 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 relacionados con https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams Borra una transmisión de video.
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 Muestra una lista de transmisiones de video que coinciden con los parámetros de 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 una transmisión nueva 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 entre los demás mensajes de las siguientes maneras:

  • Los Súper chats se destacan con un color.
  • Los Súper chats permanecen fijados 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 relacionados con https://www.googleapis.com/youtube/v3
list GET /superChatEvents Muestra una lista de los eventos de Súper chat de las transmisiones en vivo de un canal en 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 ofrece 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 y único a un canal. Consulta el Centro de ayuda de YouTube para obtener más información sobre Fan Funding.

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 relacionados con https://www.googleapis.com/youtube/v3
list GET /fanFundingEvents Muestra una lista de 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 de la transmisión.

Nota: El comando de API para controlar los puntos de inserción 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 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 relacionados con https://www.googleapis.com/
insert POST /liveCuepoints Inserta un punto de inserción en una transmisión en vivo. Actualmente, las solicitudes a este método deben estar autorizadas por una cuenta asociada a un propietario del contenido de YouTube.

Patrocinadores

Un recurso sponsor representa a un patrocinador de un canal de YouTube. Un patrocinador proporciona asistencia monetaria 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.

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 relacionados con https://www.googleapis.com/youtube/v3
list GET /sponsors Muestra una lista de los patrocinadores de un canal. El propietario del canal debe autorizar la solicitud a la API.