YouTube Live Streaming API - Errors

En este documento, se identifican los diferentes tipos de errores que pueden mostrar las operaciones 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.

fanFundingEvents

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

fanFundingEvents.list

Tipo de error Detalle del error Descripción
forbidden (403) insufficientPermissions No tienes los permisos necesarios para ver los eventos de financiación de fans del canal.
invalidValue (400) fanFundingNotEnabledForChannelId El canal no tiene habilitada la financiación de fans.

liveBroadcasts

En las siguientes tablas se identifican los mensajes de error que muestra la API en respuesta a 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 Cómo implementar la autenticación de OAuth2.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no está habilitado para transmitir video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound La transmisión especificada por el parámetro id no existe.
notFound (404) liveStreamNotFound La transmisión especificada por el parámetro streamId no existe.
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 tiene autorización para borrar la transmisión en vivo especificada. Para obtener más información, consulta Cómo implementar la autenticación de OAuth2.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no está habilitado para transmitir 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 de transmisión en vivo no identificó una transmisión.

liveBroadcasts.insert

Tipo de error Detalle del error Descripción
insufficientPermissions insufficientLivePermissions La solicitud no tiene autorización para crear la transmisión en vivo.
insufficientPermissions livePermissionBlocked El usuario que autorizó la solicitud no puede transmitir un video en vivo en YouTube en este momento. Los detalles que explican por qué el usuario no puede transmitir video en vivo pueden estar disponibles en la configuración del canal del usuario en https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no está habilitado para transmitir 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 contiene 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 contiene un valor no válido para la propiedad contentDetails.enableAutoStop. No se puede modificar la configuración de 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 contiene un valor no válido para la propiedad contentDetails.enable_embed. No puedes insertar esta transmisión.
invalidValue (400) invalidLatencyPreferenceOptions El recurso liveBroadcast contiene 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 contiene un valor no válido para la propiedad status.privacy_status.
invalidValue (400) invalidProjection El recurso liveBroadcast contiene 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 contiene un valor no válido para la propiedad snippet.scheduledEndTime. La hora de finalización programada debe coincidir con la hora de inicio programada.
invalidValue (400) invalidScheduledStartTime El recurso liveBroadcast contiene 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 una transmisión pueda programarse de forma confiable en ese momento.
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 programadas o en vivo y 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 tiene autorización para recuperar la transmisión en vivo.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no está habilitado para transmitir 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 está permitida cuando la transmisión vinculada a la transmisión está inactiva.
forbidden (403) invalidTransition La transmisión en vivo no puede pasar de su estado actual al estado solicitado.
forbidden (403) redundantTransition La transmisión en vivo ya se encuentra en el estado solicitado o procesando el estado solicitado.
insufficientPermissions insufficientLivePermissions La solicitud no tiene autorización para realizar la transición de la transmisión en vivo.
insufficientPermissions livePermissionBlocked El usuario que autorizó la solicitud no puede transmitir un video en vivo en YouTube en este momento. Los detalles que explican por qué el usuario no puede transmitir video en vivo pueden estar disponibles en la configuración del canal del usuario en https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no está habilitado para transmitir video en vivo en YouTube. El usuario puede encontrar más información en https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound La transmisión especificada por el parámetro id no existe.
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 cuyo estado quieres 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 contentDetails.closedCaptionsType solo se puede modificar cuando la transmisión está en el estado created o ready.
forbidden (403) enableAutoStartModificationNotAllowed El valor contentDetails.enableAutoStart solo se puede modificar cuando la transmisión está inactiva y tiene el estado created o ready.
forbidden (403) enableClosedCaptionsModificationNotAllowed El valor contentDetails.enableClosedCaptions solo se puede modificar cuando el estado de la transmisión es created o ready.
forbidden (403) enableDvrModificationNotAllowed El valor contentDetails.enableDvr solo se puede modificar cuando el estado de la transmisión es created o ready.
forbidden (403) enableMonitorStreamModificationNotAllowed El valor contentDetails.monitorStream.enableMonitorStream solo se puede modificar cuando el estado de la transmisión es created o ready.
forbidden (403) recordFromStartModificationNotAllowed El valor 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 Cómo implementar la autenticación de OAuth2.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no está habilitado para transmitir 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 contiene un valor no válido para la propiedad contentDetails.enableAutoStart. No se puede modificar la configuración de enableAutoStart para una transmisión persistente.
invalidValue (400) invalidAutoStop El recurso liveBroadcast contiene un valor no válido para la propiedad contentDetails.enableAutoStop. No se puede modificar la configuración de 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 contiene un valor no válido para la propiedad contentDetails.enable_embed. No puedes insertar esta transmisión.
invalidValue (400) invalidEnableClosedCaptions En el recurso liveBroadcast, el valor de la propiedad contentDetails.enableClosedCaptions no es compatible con el valor de la configuración contentDetails.closedCaptionType. Modifica el recurso para que incluya solo una de las dos propiedades y, luego, vuelve a enviar la solicitud.
invalidValue (400) invalidLatencyPreferenceOptions El recurso liveBroadcast contiene 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 ha especificado un estado de privacidad válido. Consulta los valores privacyStatus válidos.
invalidValue (400) invalidProjection El recurso liveBroadcast contiene 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 contiene un valor no válido para la propiedad snippet.scheduledEndTime. La hora de finalización programada debe coincidir con la hora de inicio programada.
invalidValue (400) invalidScheduledStartTime El recurso liveBroadcast contiene un valor no válido para la propiedad snippet.scheduledStartTime. La hora de inicio programada debe ser posterior a la 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 de transmisión en vivo 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 No se especificó un estado de privacidad en el recurso liveBroadcast. Consulta para ver los valores de privacyStatus válidos.
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 inserción en la transmisión en vivo.
insufficientPermissions (403) liveStreamingNotEnabled El usuario que autorizó la solicitud no está habilitado para transmitir 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 inserción.
required (400) cueTypeRequired El campo cueType obligatorio debe especificarse en el cuerpo de la solicitud a la API.
notFound (404) liveBroadcastNotFound La transmisión especificada por el parámetro id no existe.
invalidValue (400) conflictingTimeFields Solo se puede especificar uno de insertionOffsetTimeMs y walltimeMs. Si estableces ambos valores, se producirá un error. Si no configuras ninguno de los valores, YouTube usará el tiempo predeterminado insertionOffsetTimeMs (0), lo que significa que el punto de inserción 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 enviar la solicitud después de unos minutos.

liveChatBans

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

liveChatBans.delete

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

liveChatBans.insert

Tipo de error Detalle del error Descripción
forbidden (403) insufficientPermissions No tienes los permisos necesarios para bloquear a un usuario del chat en vivo especificado.
forbidden (403) liveChatBanInsertionNotAllowed No se puede crear el bloqueo especificado. Este error puede ocurrir si la solicitud intenta bloquear al propietario del chat o a otro moderador.
invalidValue (400) invalidChannelId No se puede encontrar el ID del canal especificado.
invalidValue (400) invalidLiveChatId El valor snippet.liveChatId especificado en la solicitud no es válido. Verifica el recurso liveBroadcast asociado para asegurarte de que tienes el valor correcto.
notFound (404) liveChatNotFound No se puede encontrar el chat en vivo especificado. Verifica el recurso liveBroadcast asociado para asegurarte de configurar la propiedad snippet.liveChatId con el valor correcto.
notFound (404) liveChatUserNotFound No se puede encontrar al usuario del chat en vivo al 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 muestra la API en respuesta a 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 puede identificar un mensaje creado por un moderador o por otro usuario cuyos mensajes no se pueden borrar.
notFound (404) liveChatMessageNotFound No se puede encontrar el mensaje que intentas eliminar. 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, lo que significa que no se pueden agregar mensajes.
forbidden (403) liveChatEnded El chat en vivo especificado ya no está en vivo.
invalidValue (400) messageTextInvalid El texto del mensaje (snippet.textMessageDetails.messageText) no es válido.
notFound (404) liveChatNotFound El chat en vivo identificado en la solicitud a la API no existe. Este error ocurre 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 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á en vivo.
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 solicitud anterior. Este error ocurre cuando las solicitudes de la API para recuperar mensajes se envían con mayor frecuencia que las frecuencias de actualización de YouTube, lo que desperdicia innecesariamente el ancho de banda.

liveCuepoints

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

liveCuepoints.insert

Tipo de error Detalle del error Descripción
invalidValue (400) conflictingTimeFields Solo se puede especificar uno de offsetTimeMs o walltime.

liveStreams

En las siguientes tablas se identifican los mensajes de error que muestra la API en respuesta a 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 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 Cómo implementar la autenticación de OAuth 2.0.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no está habilitado para transmitir video en vivo en YouTube. Para obtener más información, consulta Elegibilidad de 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 El usuario que autorizó la solicitud no puede transmitir un video en vivo en YouTube en este momento. Los detalles que explican por qué el usuario no puede transmitir video en vivo pueden estar disponibles en la configuración del canal del usuario en https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no está habilitado para transmitir 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 muestra 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 muestra 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 está habilitado para transmitir 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 El ciclo 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 crear la transmisión.
forbidden (403) liveStreamModificationNotAllowed La API no te permite cambiar una transmisión reutilizable para que no se pueda reutilizar, ni viceversa. Para obtener más información, consulta Información sobre las transmisiones y las transmisiones.
insufficientPermissions insufficientLivePermissions La solicitud no tiene autorización para actualizar la transmisión en vivo especificada. Para obtener más información, consulta Cómo implementar la autenticación de OAuth2.
insufficientPermissions liveStreamingNotEnabled El usuario que autorizó la solicitud no está habilitado para transmitir 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.

patrocinadores

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

sponsors.list

Tipo de error Detalle del error Descripción
forbidden (403) insufficientPermissions No tienes los permisos necesarios para ver los patrocinadores del canal.
invalidValue (400) invalidValueInRequest La solicitud contiene un valor no válido.
invalidValue (400) sponsorshipNotEnabledForChannelId El canal no tiene habilitados los patrocinios.