YouTube Live Streaming API - Errors

En este documento, se identifican los diferentes tipos de errores que pueden devolver las operaciones de YouTube Live Streaming API. También puedes encontrar una lista de errores para cualquier método individual en la documentación de referencia para dicho método.

liveBroadcasts

En las siguientes tablas, se identifican los mensajes de error que devuelve la API en respuesta a las llamadas relacionadas con los recursos liveBroadcasts.

liveBroadcasts.bind

Tipo de error Detalle del error Descripción
backendError internalError Se produjo un error interno durante la vinculación.
forbidden (403) liveBroadcastBindingNotAllowed El estado actual de la transmisión en vivo no permite que se vincule a una transmisión.
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para recuperar la transmisión en vivo especificada. Para obtener más información, consulta Implementa la autenticación de OAuth2.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound No existe la transmisión especificada por el parámetro id.
notFound (404) liveStreamNotFound No existe la transmisión especificada por el parámetro streamId.
rateLimitExceeded userRequestsExceedRateLimit El usuario envió demasiadas solicitudes en un período determinado.
required (400) idRequired El parámetro id obligatorio debe identificar la transmisión que se vinculará.

liveBroadcasts.delete

Tipo de error Detalle del error Descripción
forbidden (403) liveBroadcastDeletionNotAllowed El estado actual de la transmisión en vivo no permite que se borre.
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para borrar la transmisión en vivo especificada. Para obtener más información, consulta Implementa la autenticación de OAuth2.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound La propiedad id especificada en el recurso liveBroadcast no identificó una transmisión.

liveBroadcasts.insert

Tipo de error Detalle del error Descripción
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para crear la transmisión en vivo.
insufficientPermissions livePermissionBlocked En este momento, el usuario que autorizó la solicitud no puede transmitir videos en vivo en YouTube. Es posible que los detalles que explican por qué el usuario no puede transmitir videos en vivo estén disponibles en la configuración del canal del usuario en https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.
invalidValue (400) invalidAutoStart El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.enableAutoStart. No todas las transmisiones admiten este parámetro de configuración.
invalidValue (400) invalidAutoStop El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.enableAutoStop. No puedes modificar el parámetro de configuración enableAutoStop para una transmisión persistente.
invalidValue (400) invalidDescription El recurso liveBroadcast no especificó un valor válido para la propiedad snippet.description. El valor de la propiedad puede contener hasta 5,000 caracteres.
invalidValue (400) invalidEmbedSetting El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.enable_embed. No puedes incorporar esta transmisión.
invalidValue (400) invalidLatencyPreferenceOptions El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.latencyPreference. No todos los parámetros de configuración son compatibles con esta preferencia de latencia.
invalidValue (400) invalidPrivacyStatus El recurso liveBroadcast contenía un valor no válido para la propiedad status.privacy_status.
invalidValue (400) invalidProjection El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.projection. La proyección de una transmisión predeterminada no se puede establecer en 360.
invalidValue (400) invalidScheduledEndTime El recurso liveBroadcast contenía un valor no válido para la propiedad snippet.scheduledEndTime. La hora de finalización programada debe ser posterior a la hora de inicio programada.
invalidValue (400) invalidScheduledStartTime El recurso liveBroadcast contenía un valor no válido para la propiedad snippet.scheduledStartTime. La hora de inicio programada debe ser posterior a la actual y lo suficientemente cercana a la fecha actual como para que se pueda programar una transmisión de forma confiable a esa hora.
invalidValue (400) invalidTitle El recurso liveBroadcast no especificó un valor válido para la propiedad snippet.title. El valor de la propiedad debe tener entre 1 y 100 caracteres.
limitExceeded userBroadcastsExceedLimit El usuario creó demasiadas transmisiones en vivo o programadas, por lo que debe detener o borrar algunas.
rateLimitExceeded userRequestsExceedRateLimit El usuario envió demasiadas solicitudes en un período determinado.
required (400) privacyStatusRequired El recurso liveBroadcast debe especificar un estado de privacidad. Consulta los valores privacyStatus válidos.
required (400) scheduledEndTimeRequired El recurso liveBroadcast debe especificar la propiedad snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired El recurso liveBroadcast debe especificar la propiedad snippet.scheduledStartTime.
required (400) titleRequired El recurso liveBroadcast debe especificar la propiedad snippet.title.

liveBroadcasts.list

Tipo de error Detalle del error Descripción
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para recuperar la transmisión en vivo.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.

liveBroadcasts.transition

Tipo de error Detalle del error Descripción
backendError errorExecutingTransition Se produjo un error al cambiar el estado de la transmisión.
forbidden (403) errorStreamInactive La transición solicitada no se permite cuando el flujo vinculado a la transmisión está inactivo.
forbidden (403) invalidTransition La transmisión en vivo no puede cambiar de su estado actual al estado solicitado.
forbidden (403) redundantTransition La transmisión en vivo ya tiene el estado solicitado o se está procesando para alcanzarlo.
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para realizar la transición de la transmisión en vivo.
insufficientPermissions livePermissionBlocked En este momento, el usuario que autorizó la solicitud no puede transmitir videos en vivo en YouTube. Es posible que los detalles que explican por qué el usuario no puede transmitir videos en vivo estén disponibles en la configuración del canal del usuario en https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound No existe la transmisión especificada por el parámetro id.
rateLimitExceeded (403) userRequestsExceedRateLimit El usuario envió demasiadas solicitudes en un período determinado.
required (400) idRequired El parámetro obligatorio id debe identificar la transmisión cuyo estado deseas cambiar.
required (400) statusRequired La solicitud a la API debe especificar un valor para el parámetro status.

liveBroadcasts.update

Tipo de error Detalle del error Descripción
forbidden (403) closedCaptionsTypeModificationNotAllowed El valor de contentDetails.closedCaptionsType solo se puede modificar cuando la transmisión está en estado created o ready.
forbidden (403) enableAutoStartModificationNotAllowed El valor de contentDetails.enableAutoStart solo se puede modificar cuando la transmisión está inactiva y la transmisión está en estado created o ready.
forbidden (403) enableClosedCaptionsModificationNotAllowed El valor de contentDetails.enableClosedCaptions solo se puede modificar cuando el estado de la transmisión es created o ready.
forbidden (403) enableDvrModificationNotAllowed El valor de contentDetails.enableDvr solo se puede modificar cuando el estado de la transmisión es created o ready.
forbidden (403) enableMonitorStreamModificationNotAllowed El valor de contentDetails.monitorStream.enableMonitorStream solo se puede modificar cuando el estado de la transmisión es created o ready.
forbidden (403) recordFromStartModificationNotAllowed El valor de contentDetails.recordFromStart solo se puede modificar cuando el estado de la transmisión es created o ready.
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para actualizar la transmisión en vivo especificada. Para obtener más información, consulta Implementa la autenticación de OAuth2.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.
invalidValue (400) invalidAutoStart El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.enableAutoStart. No puedes modificar el parámetro de configuración enableAutoStart de una transmisión persistente.
invalidValue (400) invalidAutoStop El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.enableAutoStop. No puedes modificar el parámetro de configuración enableAutoStop para una transmisión persistente.
invalidValue (400) invalidDescription El recurso liveBroadcast no especificó un valor válido para la propiedad snippet.description. snippet.description puede contener hasta 5,000 caracteres.
invalidValue (400) invalidEmbedSetting El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.enable_embed. No puedes incorporar esta transmisión.
invalidValue (400) invalidEnableClosedCaptions En el recurso liveBroadcast, el valor de la propiedad contentDetails.enableClosedCaptions es incompatible con el valor del parámetro de configuración contentDetails.closedCaptionType. Modifica el recurso para que solo incluya una de las dos propiedades y, luego, vuelve a enviar la solicitud.
invalidValue (400) invalidLatencyPreferenceOptions El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.latencyPreference. No todos los parámetros de configuración son compatibles con esta preferencia de latencia.
invalidValue (400) invalidPrivacyStatus El recurso liveBroadcast no especificó un estado de privacidad válido. Consulta los valores privacyStatus válidos.
invalidValue (400) invalidProjection El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.projection. La proyección de una transmisión persistente no se puede establecer en 360.
invalidValue (400) invalidScheduledEndTime El recurso liveBroadcast contenía un valor no válido para la propiedad snippet.scheduledEndTime. La hora de finalización programada debe ser posterior a la hora de inicio programada.
invalidValue (400) invalidScheduledStartTime El recurso liveBroadcast contenía un valor no válido para la propiedad snippet.scheduledStartTime. La hora de inicio programada debe ser posterior a la hora actual.
invalidValue (400) invalidTitle El recurso liveBroadcast no especificó un valor válido para la propiedad snippet.title. snippet.title debe tener entre 1 y 100 caracteres.
notFound (404) liveBroadcastNotFound La propiedad id especificada en el recurso liveBroadcast no identificó una transmisión.
required (400) broadcastStreamDelayMsRequired El recurso liveBroadcast no especificó la propiedad contentDetails.monitorStream.broadcastStreamDelayMs.
required (400) enableMonitorStreamRequired El recurso liveBroadcast no especificó la propiedad contentDetails.monitorStream.enableMonitorStream.
required (400) idRequired El recurso liveBroadcast debe incluir y especificar un valor para la propiedad id.
required (400) privacyStatusRequired El recurso liveBroadcast no especificó un estado de privacidad. Consulta para ver los valores válidos de privacyStatus.
required (400) scheduledEndTimeRequired El recurso liveBroadcast no especificó la propiedad snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired El recurso liveBroadcast no especificó la propiedad snippet.scheduledStartTime.
required (400) titleRequired El recurso liveBroadcast no especificó la propiedad snippet.title.

liveBroadcasts.cuepoint

Tipo de error Detalle del error Descripción
insufficientPermissions (403) insufficientLivePermissions La solicitud no está autorizada para insertar un punto de referencia en la transmisión en vivo.
insufficientPermissions (403) liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. El usuario puede encontrar más información en https://support.google.com/youtube/answer/2474026 y https://www.youtube.com/features.
rateLimitExceeded (403) userRequestsExceedRateLimit El usuario envió demasiadas solicitudes en un período determinado.
required (400) idRequired El parámetro id obligatorio debe identificar la transmisión en la que deseas insertar un punto de referencia.
required (400) cueTypeRequired El campo cueType obligatorio debe especificarse en el cuerpo de la solicitud a la API.
notFound (404) liveBroadcastNotFound No existe la transmisión especificada por el parámetro id.
invalidValue (400) conflictingTimeFields Solo se puede especificar uno de insertionOffsetTimeMs y walltimeMs. Si se configuran ambos valores, se genera un error. Si no estableces ninguno de los dos valores, YouTube usará el tiempo insertionOffsetTimeMs predeterminado (0), lo que significa que el punto de referencia se insertará lo antes posible.
invalidValue (400) invalidInsertionOffsetTimeMs El recurso cuepoint especificó un valor no válido para la propiedad insertionOffsetTimeMs. El valor debe ser 0 o un número entero positivo.
invalidValue (400) invalidWalltimeMs El recurso cuepoint especificó un valor no válido para la propiedad walltimeMs. El valor debe ser un número entero que represente una marca de tiempo de época.
backendError (5xx) serviceUnavailable El servicio no está disponible. Vuelve a intentarlo en unos minutos.

liveChatBans

En las siguientes tablas, se identifican los mensajes de error que devuelve la API en respuesta a las llamadas relacionadas con los recursos liveChatBans.

liveChatBans.delete

Tipo de error Detalle del error Descripción
forbidden (403) forbidden No se puede quitar la prohibición especificada. Este error puede ocurrir si la solicitud está autorizada por un moderador que intenta quitar la prohibición a otro moderador.
forbidden (403) insufficientPermissions No tienes los permisos necesarios para quitar la prohibición especificada.
invalidValue (400) invalidLiveChatBanId El parámetro id especifica un valor no válido.
notFound (404) liveChatBanNotFound No se encontró la prohibición especificada.

liveChatBans.insert

Tipo de error Detalle del error Descripción
forbidden (403) insufficientPermissions No tienes los permisos necesarios para prohibir que un usuario participe en el chat en vivo especificado.
forbidden (403) liveChatBanInsertionNotAllowed No se puede crear la prohibición especificada. Este error puede ocurrir si la solicitud intenta prohibir al propietario del chat o a otro moderador.
invalidValue (400) invalidChannelId No se encuentra el ID de canal especificado.
invalidValue (400) invalidLiveChatId El valor de snippet.liveChatId especificado en la solicitud no es válido. Verifica el recurso liveBroadcast asociado para asegurarte de tener el valor correcto.
notFound (404) liveChatNotFound No se puede encontrar el chat en vivo especificado. Verifica el recurso liveBroadcast asociado para asegurarte de que estás configurando la propiedad snippet.liveChatId con el valor correcto.
notFound (404) liveChatUserNotFound No se encontró al usuario del chat en vivo que intentas bloquear.
required (400) bannedUserChannelIdRequired El recurso liveChatBan enviado en el cuerpo de la solicitud debe especificar un valor para la propiedad snippet.bannedUserDetails.channelId.
required (400) liveChatIdRequired El recurso liveChatBan enviado en el cuerpo de la solicitud debe especificar un valor para la propiedad snippet.liveChatId.

liveChatMessages

En las siguientes tablas, se identifican los mensajes de error que devuelve la API en respuesta a las llamadas relacionadas con los recursos liveChatMessages.

liveChatMessages.delete

Tipo de error Detalle del error Descripción
forbidden (403) forbidden No tienes los permisos necesarios para borrar el mensaje especificado.
forbidden (403) modificationNotAllowed No se puede borrar el recurso liveChatMessage especificado. El parámetro id podría identificar un mensaje creado por un moderador o por otro usuario cuyos mensajes no se pueden borrar.
notFound (404) liveChatMessageNotFound No se encontró el mensaje que intentas borrar. Comprueba el valor del parámetro id para asegurarte de que sea correcto.

liveChatMessages.insert

Tipo de error Detalle del error Descripción
forbidden (403) forbidden No tienes los permisos necesarios para crear el mensaje especificado.
forbidden (403) liveChatDisabled El propietario inhabilitó el chat en vivo especificado, por lo que no se pueden agregar mensajes.
forbidden (403) liveChatEnded El chat en vivo especificado ya no está activo.
invalidValue (400) messageTextInvalid El texto del mensaje (snippet.textMessageDetails.messageText) no es válido.
notFound (404) liveChatNotFound No existe el chat en vivo identificado en la solicitud de API. Este error se produce si el propietario borró el chat.
rateLimitExceeded rateLimitExceeded El usuario publicó demasiados mensajes de chat en un período determinado.
required (400) liveChatIdRequired El recurso liveChatMessage debe incluir y especificar un valor para la propiedad snippet.liveChatId.
required (400) messageTextRequired El recurso liveChatMessage debe incluir y especificar un valor para la propiedad snippet.textMessageDetails.messageText.
required (400) typeRequired El recurso liveChatMessage debe incluir y especificar un valor para la propiedad snippet.type. Establece el valor del parámetro en text.

liveChatMessages.list

Tipo de error Detalle del error Descripción
forbidden (403) forbidden No tienes los permisos necesarios para recuperar los mensajes del chat en vivo especificado.
forbidden (403) liveChatDisabled El chat en vivo no está habilitado para la transmisión especificada.
forbidden (403) liveChatEnded El chat en vivo especificado ya no está activo.
notFound (404) liveChatNotFound No se puede encontrar el chat en vivo que intentas recuperar. Comprueba el valor del parámetro liveChatId de la solicitud para asegurarte de que sea correcto.
rateLimitExceeded rateLimitExceeded La solicitud se envió demasiado rápido después de la anterior. Este error ocurre cuando las solicitudes a la API para recuperar mensajes se envían con mayor frecuencia que las tasas de actualización de YouTube, lo que desperdicia ancho de banda de forma innecesaria.

liveChatMessages.streamlist

Tipo de error Detalle del error Descripción
INVALID_ARGUMENT (3) LIVE_CHAT_ENDED No puedes recuperar los mensajes del chat en vivo finalizado.
PERMISSION_DENIED (7) forbidden No tienes los permisos necesarios para recuperar los mensajes del chat en vivo especificado.
PERMISSION_DENIED (7) liveChatDisabled El chat en vivo no está habilitado para la transmisión especificada.
PERMISSION_DENIED (7) liveChatEnded El chat en vivo especificado ya no está activo.
NOT_FOUND (5) liveChatNotFound No se puede encontrar el chat en vivo que intentas recuperar. Comprueba el valor del parámetro liveChatId de la solicitud para asegurarte de que sea correcto.
RESOURCE_EXHAUSTED (8) rateLimitExceeded La solicitud se envió demasiado rápido después de la anterior. Este error ocurre cuando las solicitudes a la API para recuperar mensajes se envían con mayor frecuencia que las tasas de actualización de YouTube, lo que desperdicia ancho de banda de forma innecesaria.

liveStreams

En las siguientes tablas, se identifican los mensajes de error que devuelve la API en respuesta a las llamadas relacionadas con los recursos liveStreams.

liveStreams.delete

Tipo de error Detalle del error Descripción
forbidden (403) liveStreamDeletionNotAllowed No se puede borrar la transmisión en vivo especificada porque está vinculada a una transmisión que aún no se completó.
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para borrar la transmisión en vivo especificada. Para obtener más información, consulta Implementa la autenticación de OAuth 2.0.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. Para obtener más información, consulta Elegibilidad de las funciones.
notFound (404) liveStreamNotFound La transmisión en vivo especificada no existe.

liveStreams.insert

Tipo de error Detalle del error Descripción
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para crear la transmisión en vivo especificada.
insufficientPermissions livePermissionBlocked En este momento, el usuario que autorizó la solicitud no puede transmitir videos en vivo en YouTube. Es posible que los detalles que explican por qué el usuario no puede transmitir videos en vivo estén disponibles en la configuración del canal del usuario en https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.
invalidValue (400) invalidDescription El valor de la propiedad snippet.description en el recurso liveStream puede tener hasta 10,000 caracteres.
invalidValue (400) invalidFormat El valor de la propiedad cdn.format en el recurso liveStream no es válido.
invalidValue (400) invalidFrameRate El valor de la propiedad cdn.frameRate en el recurso liveStream no es válido.
invalidValue (400) invalidIngestionType El valor de la propiedad cdn.ingestionType en el recurso liveStream no es válido.
invalidValue (400) invalidResolution El valor de la propiedad cdn.resolution en el recurso liveStream no es válido.
invalidValue (400) invalidTitle El valor de la propiedad snippet.title en el recurso liveStream debe tener entre 1 y 128 caracteres.
rateLimitExceeded userRequestsExceedRateLimit El usuario envió demasiadas solicitudes en un período determinado.
required (400) cdnRequired El recurso liveStream debe contener el objeto cdn.
required (400) frameRateRequired La API devuelve este error si especificas un valor para la propiedad cdn.resolution, pero no para la propiedad cdn.frameRate.
required (400) ingestionTypeRequired El recurso liveStream debe especificar un valor para la propiedad cdn.ingestionType>.
required (400) resolutionRequired La API devuelve este error si especificas un valor para la propiedad cdn.frameRate, pero no para la propiedad cdn.resolution.
required (400) titleRequired El recurso liveStream debe especificar un valor para la propiedad snippet.title.

liveStreams.list

Tipo de error Detalle del error Descripción
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para recuperar la transmisión en vivo especificada.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.

liveStreams.update

Tipo de error Detalle del error Descripción
forbidden (403) liveStreamModificationNotAllowed No se puede modificar la transmisión en vivo especificada en su estado actual. Para obtener más información, consulta Ciclo de vida de una transmisión.
forbidden (403) liveStreamModificationNotAllowed La API no te permite cambiar el valor de los campos cdn.format, cdn.frameRate, cdn.ingestionType o cdn.resolution después de que se crea la transmisión.
forbidden (403) liveStreamModificationNotAllowed La API no te permite cambiar un flujo reutilizable para que no sea reutilizable, ni viceversa. Para obtener más información, consulta Información sobre las transmisiones y los streams.
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para actualizar la transmisión en vivo especificada. Para obtener más información, consulta Implementa la autenticación de OAuth2.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no tiene habilitada la transmisión de video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.
invalidValue (400) invalidDescription El valor de la propiedad snippet.description en el recurso liveStream puede tener hasta 10,000 caracteres.
invalidValue (400) invalidTitle El valor de la propiedad snippet.title en el recurso liveStream debe tener entre 1 y 128 caracteres.
notFound (404) liveStreamNotFound La transmisión en vivo especificada no existe.
required (400) idRequired El recurso liveStream debe especificar un valor para la propiedad id.
required (400) ingestionTypeRequired El recurso liveStream debe especificar un valor para la propiedad cdn.ingestionType.
required (400) titleRequired El recurso liveStream debe especificar un valor para la propiedad snippet.title.