YouTube API Quota Exceeded: Causes and Fixes

Chaque projet Google Cloud reçoit par défaut un quota de l'API YouTube Data v3 de 10 000 unités par jour, réinitialisé à minuit heure du Pacifique - sans report et sans moyen de déclencher une réinitialisation anticipée. Le quota est suivi par projet, pas par clé API, donc générer une deuxième clé depuis le même projet ne vous donne pas un second pool.

Chaque appel API coûte des unités, pas des requêtes - et les coûts sont inégaux. Voici le tableau complet des points d'accès réellement utilisés par les développeurs :

À 100 unités par recherche, un projet peut épuiser tout son quota quotidien après seulement 100 appels de recherche - avant même le téléchargement d'un seul sous-titre. C'est la manière la plus courante dont les petits projets atteignent la limite : ils n'ont pas effectué 10 000 requêtes, ils en ont fait quelques centaines de coûteuses. À l'inverse, videos.list, channels.list, et playlistItems.list sont peu coûteux à 1 unité chacun - si vous connaissez déjà un ID de vidéo, de chaîne, ou de playlist, ces appels entament à peine le budget quotidien.

1. Ouvrez la Google Cloud Console pour le projet lié à votre clé API.
2. Allez dans APIs & Services → YouTube Data API v3 → Quotas & System Limits.
3. Cela affiche votre utilisation actuelle par rapport aux requêtes par jour et aux limites par minute, mis à jour avec un léger délai plutôt qu'en temps réel.

Si vous êtes déjà proche du plafond avant d'avoir effectué 10 000 requêtes, cette vue permet de confirmer qu'il s'agit du problème des appels coûteux ci-dessus, et non d'un bug.

Les deux renvoient un 403, et les deux sont regroupés dans la conversation courante sous le terme "erreurs de quota", mais ce sont des problèmes différents avec des correctifs différents :

• quotaExceeded (raison : dailyLimitExceeded) - votre projet a utilisé toute son allocation d'unités quotidienne. Rien ne corrige cela sauf attendre la réinitialisation de minuit heure du Pacifique, réduire le coût par appel, ou obtenir une augmentation de quota approuvée.
• rateLimitExceeded - vous envoyez des requêtes trop rapidement sur une courte fenêtre, indépendamment de votre total quotidien. C'est un problème de cadence, pas de budget - consultez notre guide sur les limites de débit pour savoir comment le gérer correctement avec un backoff.

1. Mettre agressivement en cache. Le quota est facturé par appel API, pas par requête utilisateur - si vous récupérez à répétition les sous-titres de la même vidéo, mettez le résultat en cache (même un simple cache en mémoire à durée de vie limitée) plutôt que d'appeler à nouveau l'API pour des données qui ne changent pas d'une minute à l'autre.
2. Éviter search.list là où une recherche directe par ID fonctionne. Si vous avez déjà un ID de vidéo, de chaîne, ou de playlist, l'appel .list correspondant est 100 fois moins cher qu'une recherche.
3. Grouper les recherches par ID. videos.list accepte jusqu'à 50 ID séparés par des virgules par appel pour le même coût de 1 unité qu'un seul ID - récupérer 50 vidéos une par une au lieu de les grouper coûte 50 fois plus cher pour rien.
4. Demander une augmentation de quota une fois que vous avez un usage réel en production pour la justifier, via le formulaire YouTube API Services Audit and Quota Extension lié depuis la page de quota de la Cloud Console. Attendez-vous à une revue manuelle, pas une approbation instantanée.
5. Utiliser une API de transcription qui ne transite pas par votre propre quota YouTube. L'API de GetYouTubeTranscript récupère les transcriptions via sa propre infrastructure plutôt que de faire transiter captions.download avec votre clé, donc il n'y a aucun plafond quotidien de 10 000 unités à gérer - seulement la limite de débit propre à l'offre.

cURL :

curl "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ" \
  -H "Authorization: Bearer sk_live_..."

Node.js :

const res = await fetch(
  "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ",
  { headers: { Authorization: `Bearer ${process.env.GETYOUTUBETRANSCRIPT_API_KEY}` } }
);
const { data } = await res.json();
console.log(data.transcript);

Python :

import os, requests

res = requests.get(
    "https://getyoutubetranscript.com/api/v1/transcript",
    params={"v": "dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {os.environ['GETYOUTUBETRANSCRIPT_API_KEY']}"},
)
print(res.json()["data"]["transcript"])

Cela coûte 1 crédit sur votre offre GetYouTubeTranscript, pas des unités sur le quota de l'API YouTube Data de votre projet Google Cloud. Obtenez 100 crédits gratuits, sans carte requise, depuis le tableau de bord, ou consultez la documentation API complète.