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.

eventos deFunFunding

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con 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.

Transmisiones en vivo

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con 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 le permite vincularse 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 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 emisión especificada por el parámetro id no existe.
notFound (404) liveStreamNotFound El flujo especificado 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 está autorizada para borrar la transmisión en vivo especificada. Para obtener más información, consulta Cómo implementar la autenticación 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 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 El usuario que autorizó la solicitud no puede transmitir video en vivo en YouTube en este momento. En https://www.youtube.com/features, puedes encontrar detalles sobre por qué el usuario no puede transmitir video en vivo en la configuración de canal del usuario.
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 contenía un valor no válido para la propiedad contentDetails.enableAutoStart. No todas las transmisiones admiten esta configuración.
invalidValue (400) invalidAutoStop El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.enableAutoStop. No puedes 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 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 todas las opciones 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 seguir 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 en el futuro y estar lo suficientemente cerca de la fecha actual como para que una transmisión pueda programarse de manera 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 en vivo o programadas, 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 válidos de privacyStatus.
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 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 se permite cuando la transmisión que está 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 se está procesando en el estado solicitado.
insufficientPermissions insufficientLivePermissions La solicitud no está autorizada para realizar la transición de la transmisión en vivo.
insufficientPermissions livePermissionBlocked El usuario que autorizó la solicitud no puede transmitir video en vivo en YouTube en este momento. En https://www.youtube.com/features, puedes encontrar detalles sobre por qué el usuario no puede transmitir video en vivo en la configuración de canal del usuario.
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 emisió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 deseas transferir.
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 si 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 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 contenía un valor no válido para la propiedad contentDetails.enableAutoStart. No puedes modificar la configuración de enableAutoStart para 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 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 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 no es compatible con el valor de la configuración contentDetails.closedCaptionType. Modifique el recurso para incluir solo una de las dos propiedades y, luego, vuelva a enviar la solicitud.
invalidValue (400) invalidLatencyPreferenceOptions El recurso liveBroadcast contenía un valor no válido para la propiedad contentDetails.latencyPreference. No todas las opciones 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 válidos de privacyStatus.
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 seguir 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 en el futuro.
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 valores 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 en 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 emisión especificada por el parámetro id no existe.
invalidValue (400) conflictingTimeFields Solo se puede especificar uno de insertionOffsetTimeMs y walltimeMs. Establecer ambos valores provoca un error. Si no estableces 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 recursos liveChatBans.

liveChatBans.delete

Tipo de error Detalle del error Descripción
forbidden (403) forbidden La prohibición especificada no se puede eliminar. Este error puede ocurrir si la solicitud está autorizada por un moderador que intenta eliminar una prohibición contra 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 que especificaste. Verifica el recurso liveBroadcast asociado para asegurarte de establecer la propiedad snippet.liveChatId en el valor correcto.
notFound (404) liveChatUserNotFound No se puede encontrar al usuario del chat en vivo que deseas bloquear.
required (400) bannedUserChannelIdRequired El recurso liveChatBan que se envió en el cuerpo de la solicitud debe especificar un valor para la propiedad snippet.bannedUserDetails.channelId.
required (400) liveChatIdRequired El recurso liveChatBan que se envió en el cuerpo de la solicitud debe especificar un valor para la propiedad snippet.liveChatId.

Mensajesdechat en vivo

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con 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 algún otro usuario cuyos mensajes no se puedan 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 que especificaste, lo que significa que no se pueden agregar mensajes al chat.
forbidden (403) liveChatEnded El chat en vivo que especificaste 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 se produce si el propietario borró el chat.
rateLimitExceeded rateLimitExceeded El usuario ha publicado demasiados mensajes de chat en un período de tiempo 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 que especificaste 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 se produce cuando las solicitudes de la API para recuperar mensajes se envían con más frecuencia que las frecuencias de actualización de YouTube, lo que desperdicia innecesariamente ancho de banda.

LiveCuepoints

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

liveCuepoints.insert

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

Transmisiones en vivo

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con 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 Cómo implementar la autenticación 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) 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 video en vivo en YouTube en este momento. En https://www.youtube.com/features, puedes encontrar detalles sobre por qué el usuario no puede transmitir video en vivo en la configuración de canal del usuario.
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 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 sea no reutilizable, o viceversa. Para obtener más información, consulta Información sobre las transmisiones y las transmisiones.
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 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 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.