Referencia de la API

En esta referencia de la API, se explica cómo programar transmisiones en vivo y transmisiones de video por Internet en YouTube mediante la API de transmisión en vivo de YouTube.

Tipos de recursos

Transmisiones en vivo

Un recurso liveBroadcast representa un evento que se transmitirá en directo mediante 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 en relación 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 puede estar vinculada 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 las 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 la 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. El punto de inserción puede activar una pausa publicitaria.

Chats en vivo

Un recurso liveChatBan identifica a un usuario y un chat en vivo de YouTube en los 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 en relación con https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Quita un bloqueo que impide que un usuario específico contribuya a un chat en vivo para que pueda volver a unirse. La solicitud de la API debe ser autorizada por el propietario del canal o un moderador del chat en vivo asociado con la prohibición.
insert POST /liveChat/bans Prohibir la participación de un usuario específico en el chat en vivo. La solicitud de la API debe ser autorizada por el propietario del canal o un moderador del chat en vivo asociado con la prohibición.

Mensajes de chat en vivo

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. (Cuando termine el evento, el chat en vivo dejará de 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
URI en relación con https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/messages Borra un mensaje de chat. La solicitud de la API debe ser autorizada por el propietario del canal o un moderador del chat en vivo asociado con la prohibición.
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.

Moderadores del chat en vivo

Un recurso liveChatModerator representa un moderador para un chat en vivo de YouTube. Un moderador de chat puede bloquear o desbloquear usuarios en un 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 en relación 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 para el chat. El propietario del canal de la transmisión en vivo debe autorizar la solicitud.
list GET /liveChat/moderators Enumera los moderadores para un chat en vivo. El propietario del canal de la transmisión en vivo debe autorizar la solicitud.

Transmisiones en vivo

Un recurso liveStream contiene información sobre la transmisión de video por Internet que estás transmitiendo 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 en relación con 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 por Internet. Las novedades te permiten 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 quieres cambiar no se pueden actualizar, debes crear una transmisión nueva con la configuración adecuada.

Patrocinadores

Un recurso sponsor representa un patrocinador para un canal de YouTube. Un patrocinador proporciona asistencia monetaria recurrente, como una tarifa de suscripción o suscripción, 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
URI en relación con 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.

Eventos de SuperChat

Un recurso superChatEvent representa un mensaje de Super Chat que compra 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 Super Chats se destacan con un color.
  • Los Súper chats permanecen fijos en el visor por un período de tiempo establecido.

El monto de compra determina el color del Super Chat, el 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 en relación con https://www.googleapis.com/youtube/v3
list GET /superChatEvents Enumera los eventos de Super Chat de las transmisiones en vivo de un canal en los últimos 30 días.

Tipos de recursos obsoletos

Eventos de financiación de fans

Un recurso fanFundingEvent representa un evento de financiación de fans en un canal de YouTube. La financiación de fans es una manera monetaria de apoyar a los creadores de YouTube. Los eventos de financiación de fans ocurren cuando un usuario realiza un pago único y voluntario 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 en relación con 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.