Referencia de errores de la API de YouTubeGuía completa de solución de problemas con soluciones

Referencia completa para errores de la API de Datos de YouTube. Encuentra soluciones para límites de carga, errores de cuota, problemas de título/miniatura y problemas de autenticación.

11 códigos de error

•

5 categorías

•

Data API v3

← Volver a Integración YouTube View API Documentation

Categorías de Errores

Autenticación

2 errors

Carga

4 errors

Cuenta

1 error

Cuota

2 errors

Contenido

2 errors

Todos los Códigos de Error

#Autenticación

invalid_grantrefresh-token

El token de acceso de YouTube ha expirado. Vuelve a conectar tu cuenta de YouTube.

Solución:

Tu token de acceso de YouTube/Google ha expirado o sido revocado. Ve a la configuración de tu cuenta y vuelve a conectar tu cuenta de YouTube para obtener un nuevo token de acceso.

token has been expired or revokedrefresh-token

El token de acceso de YouTube ha expirado. Vuelve a conectar tu cuenta de YouTube.

Solución:

Tu token ya no es válido. Esto puede suceder después de un cambio de contraseña o revisión de seguridad. Vuelve a conectar tu cuenta de YouTube para establecer una nueva sesión.

#Carga

invalidTitleuser-error

El título del video es demasiado largo. Los títulos de YouTube deben tener 100 caracteres o menos.

Solución:

Acorta el título de tu video a 100 caracteres o menos. YouTube aplica estrictamente este límite para todas las cargas de video.

failedPreconditionuser-error

El tamaño de la miniatura es demasiado grande. Usa una imagen más pequeña (máximo 2 MB).

Solución:

Tu miniatura personalizada excede el límite de tamaño de 2 MB de YouTube. Comprime tu imagen de miniatura a menos de 2 MB. El tamaño recomendado es 1280x720 píxeles.

youtube.thumbnailuser-error

Tu cuenta de YouTube no está verificada. Subimos tu video pero no pudimos configurar la miniatura. Verifica tu cuenta e inténtalo de nuevo.

Solución:

Las cuentas de YouTube no verificadas no pueden configurar miniaturas personalizadas. Verifica tu cuenta en youtube.com/verify usando un número de teléfono. El video se cargó exitosamente.

uploadLimitExceededuser-error

Has alcanzado tu límite diario de carga de YouTube. Inténtalo de nuevo mañana.

Solución:

YouTube limita las cargas según el estado de tu cuenta. Las cuentas nuevas pueden estar limitadas a 10 cargas por día. Espera 24 horas o verifica tu cuenta en youtube.com/verify.

#Cuenta

youtubeSignupRequireduser-error

La configuración del canal de YouTube no está completa. Crea un canal de YouTube antes de cargar videos.

Solución:

Primero necesitas crear un canal de YouTube. Ve a youtube.com y haz clic en 'Crear un canal'. Sigue el asistente de configuración para completar la creación de tu canal.

#Cuota

quotaExceededretry

Se excedió la cuota de la API de YouTube. Inténtalo de nuevo más tarde.

Solución:

Has excedido los límites de cuota de la API de YouTube. La cuota predeterminada es de 10,000 unidades por día. Espera hasta que tu cuota se restablezca (medianoche hora del Pacífico) o solicita un aumento de cuota a Google.

quotaretry

Se excedió la cuota de la API de YouTube. Inténtalo de nuevo más tarde.

Solución:

La API de Datos de YouTube tiene cuotas de uso. Cada operación cuesta unidades de cuota. Espera el restablecimiento de cuota u optimiza el uso de tu API para reducir el consumo de cuota.

#Contenido

copyrightuser-error

El video puede contener contenido con derechos de autor. Revisa las políticas de derechos de autor de YouTube.

Solución:

YouTube detectó posibles problemas de derechos de autor. Asegúrate de tener derechos sobre todo el contenido de tu video. Revisa las pautas de derechos de autor de YouTube y usa música/material con licencia libre de derechos.

content iduser-error

El video puede contener contenido con derechos de autor. Revisa las políticas de derechos de autor de YouTube.

Solución:

Content ID coincidió tu video con material con derechos de autor. Si tienes permiso, puedes disputar el reclamo. De lo contrario, elimina el contenido con derechos de autor y vuelve a cargar.

Mejores Prácticas

Manejo de Errores

→Monitorear uso de cuota y optimizar llamadas API
→Validar longitud de título y tamaño de miniatura antes de cargar
→Manejar requisitos de verificación de cuenta
→Implementar detección de derechos de autor

Consejos de Prevención

→Mantener títulos menores a 100 caracteres
→Usar miniaturas menores a 2 MB (1280x720 recomendado)
→Verificar cuenta para miniaturas personalizadas
→Usar solo contenido original o con licencia

¿Necesitas Ayuda con YouTube Integración?

Nuestra API maneja escenarios de error automáticamente con lógica de reintento inteligente y registro detallado.

Comenzar a Construir Ver Documentación