Référence des erreurs de l'API YouTubeGuide complet de dépannage avec solutions

Référence complète pour les erreurs de l'API de données YouTube. Trouvez des solutions pour les limites de téléchargement, les erreurs de quota, les problèmes de titre/miniature et les problèmes d'authentification.

11 codes d'erreur
5 catégories
Data API v3

Catégories d'Erreurs

Authentification

2 errors

Téléchargement

4 errors

Compte

1 error

Quota

2 errors

Contenu

2 errors

Tous les Codes d'Erreur

#Authentification

invalid_grantrefresh-token

Le jeton d'accès YouTube a expiré. Veuillez reconnecter votre compte YouTube.

Solution :

Votre jeton d'accès YouTube/Google a expiré ou a été révoqué. Allez dans les paramètres de votre compte et reconnectez votre compte YouTube pour obtenir un nouveau jeton d'accès.

token has been expired or revokedrefresh-token

Le jeton d'accès YouTube a expiré. Veuillez reconnecter votre compte YouTube.

Solution :

Votre jeton n'est plus valide. Cela peut se produire après un changement de mot de passe ou une révision de sécurité. Reconnectez votre compte YouTube pour établir une nouvelle session.

#Téléchargement

invalidTitleuser-error

Le titre de la vidéo est trop long. Les titres YouTube doivent contenir 100 caractères ou moins.

Solution :

Raccourcissez le titre de votre vidéo à 100 caractères ou moins. YouTube applique strictement cette limite pour tous les téléchargements de vidéos.

failedPreconditionuser-error

La taille de la miniature est trop grande. Veuillez utiliser une image plus petite (max 2 Mo).

Solution :

Votre miniature personnalisée dépasse la limite de 2 Mo de YouTube. Compressez votre image miniature à moins de 2 Mo. La taille recommandée est 1280x720 pixels.

youtube.thumbnailuser-error

Votre compte YouTube n'est pas vérifié. Nous avons téléchargé votre vidéo mais n'avons pas pu définir la miniature. Veuillez vérifier votre compte et réessayer.

Solution :

Les comptes YouTube non vérifiés ne peuvent pas définir de miniatures personnalisées. Vérifiez votre compte sur youtube.com/verify en utilisant un numéro de téléphone. La vidéo a été téléchargée avec succès.

uploadLimitExceededuser-error

Vous avez atteint votre limite quotidienne de téléchargement YouTube. Veuillez réessayer demain.

Solution :

YouTube limite les téléchargements en fonction de l'état de votre compte. Les nouveaux comptes peuvent être limités à 10 téléchargements par jour. Attendez 24 heures ou vérifiez votre compte sur youtube.com/verify.

#Compte

youtubeSignupRequireduser-error

La configuration de la chaîne YouTube n'est pas terminée. Veuillez créer une chaîne YouTube avant de télécharger des vidéos.

Solution :

Vous devez d'abord créer une chaîne YouTube. Allez sur youtube.com et cliquez sur 'Créer une chaîne'. Suivez l'assistant de configuration pour terminer la création de votre chaîne.

#Quota

quotaExceededretry

Quota de l'API YouTube dépassé. Veuillez réessayer plus tard.

Solution :

Vous avez dépassé les limites de quota de l'API YouTube. Le quota par défaut est de 10 000 unités par jour. Attendez que votre quota se réinitialise (minuit heure du Pacifique) ou demandez une augmentation de quota à Google.

quotaretry

Quota de l'API YouTube dépassé. Veuillez réessayer plus tard.

Solution :

L'API de données YouTube a des quotas d'utilisation. Chaque opération coûte des unités de quota. Attendez la réinitialisation du quota ou optimisez votre utilisation de l'API pour réduire la consommation de quota.

#Contenu

copyrightuser-error

La vidéo peut contenir du contenu protégé par des droits d'auteur. Veuillez consulter les politiques de droits d'auteur de YouTube.

Solution :

YouTube a détecté d'éventuels problèmes de droits d'auteur. Assurez-vous d'avoir les droits sur tout le contenu de votre vidéo. Consultez les directives de droits d'auteur de YouTube et utilisez de la musique/des séquences libres de droits.

content iduser-error

La vidéo peut contenir du contenu protégé par des droits d'auteur. Veuillez consulter les politiques de droits d'auteur de YouTube.

Solution :

Content ID a fait correspondre votre vidéo à du matériel protégé par des droits d'auteur. Si vous avez la permission, vous pouvez contester la réclamation. Sinon, supprimez le contenu protégé par des droits d'auteur et retéléchargez.

Meilleures Pratiques

Gestion des Erreurs

  • Surveiller l'utilisation du quota et optimiser les appels API
  • Valider la longueur du titre et la taille de la miniature avant le téléchargement
  • Gérer les exigences de vérification de compte
  • Implémenter la détection des droits d'auteur

Conseils de Prévention

  • Garder les titres de moins de 100 caractères
  • Utiliser des miniatures de moins de 2 Mo (1280x720 recommandé)
  • Vérifier le compte pour les miniatures personnalisées
  • Utiliser uniquement du contenu original ou sous licence

Besoin d'Aide pour YouTube l'Intégration?

Notre API gère automatiquement les scénarios d'erreur avec une logique de nouvelle tentative intelligente et une journalisation détaillée.