Referencia de la API

Esta referencia de la API explica cómo programar transmisiones en directo y transmisiones de video por Internet en YouTube utilizando la API de transmisión en directo de YouTube.

Tipos de recursos

LiveBroadcasts

Un recurso liveBroadcast representa un evento que se transmitirá, a través de video en vivo, 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
URI 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 puede estar vinculada a una transmisión de video por Internet, aunque una transmisión de video por Internet puede estar vinculada a más de una transmisión.
delete DELETE /liveBroadcasts Elimina 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 e inicia cualquier proceso asociado con el estado nuevo. Por ejemplo, cuando cambias el estado de una transmisión a testing, YouTube comienza a transmitir video a la transmisión continua de 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. El punto de inserción puede activar 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 tiene prohibido 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
URI relacionados con https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Quita el bloqueo que impide que un usuario específico contribuya al chat en vivo, lo que le permite volver a unirse. El propietario del canal o un moderador del chat en vivo asociado con el bloqueo debe autorizar la solicitud a la API.
insert POST /liveChat/bans Se le impide a un usuario específico participar en el chat en vivo. El propietario del canal o un moderador del chat en vivo asociado con el bloqueo debe autorizar la solicitud a la API.

LiveChatMessages

Un recurso liveChatMessage representa un mensaje en un chat en vivo de YouTube. El recurso puede contener detalles sobre varios tipos de mensajes, como mensajes de texto publicados recientemente o eventos 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. (Una vez finalizado el evento, el chat en vivo deja de 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
URI 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 el bloqueo 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 un moderador de un chat en vivo de YouTube. Los moderadores del chat pueden bloquear o desbloquear usuarios en el chat, quitar mensajes y realizar otras acciones administrativas para 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
URI relacionados con https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/moderators Quita un moderador del chat. La solicitud debe estar autorizada por el propietario del canal de la transmisión en vivo.
insert POST /liveChat/moderators Agrega un moderador nuevo para el chat. La solicitud debe estar autorizada por el propietario del canal de la transmisión en vivo.
list GET /liveChat/moderators Muestra una lista de los moderadores de un chat en vivo. La solicitud debe estar autorizada por el propietario del canal de la transmisión en vivo.

LiveStreams

Un recurso liveStream contiene información sobre la transmisión de video por Internet que transmites 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
URI relacionados con https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams Elimina una transmisión de video por Internet.
insert POST /liveStreams Crea una transmisión de video por Internet. La transmisión te permite enviar tu video a YouTube, que luego puede transmitir el video a tu público.
list GET /liveStreams Muestra una lista de transmisiones de video por Internet que coinciden con los parámetros de solicitud de la API.
update PUT /liveStreams Actualiza una transmisión de video por Internet. Si las propiedades que deseas cambiar no se pueden actualizar, deberás 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 la transmisión del chat en vivo de YouTube, los Súper chats se destacan de los demás mensajes de las siguientes dos maneras:

  • Los Súper chats se destacan con un color.
  • Los Súper chats permanecen fijados en el visor por un período determinado.

El importe de la compra determina el color del Súper chat, el período de tiempo que permanece fijo en el visor y la longitud máxima del mensaje. 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
URI relacionados con https://www.googleapis.com/youtube/v3
list GET /superChatEvents Enumera 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 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 y ú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
URI relacionados con https://www.googleapis.com/youtube/v3
list GET /fanFundingEvents Se muestran 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 por Internet.

Nota: El comando de la 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
URI 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 con un propietario del contenido de YouTube.

Patrocinadores

Un recurso sponsor representa un patrocinador de un canal de YouTube. Un patrocinador le brinda a un creador apoyo monetario recurrente, como una suscripción o una tarifa de membresía, y recibe beneficios especiales. Por ejemplo, los patrocinadores pueden chatear cuando el creador activa el modo solo 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
URI 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.