YouTube API Quota Exceeded: Causes and Fixes

Todo projeto do Google Cloud recebe uma cota padrão de 10.000 unidades por dia para a YouTube Data API v3, reiniciada à meia-noite no horário do Pacífico - não há acúmulo de saldo nem forma de disparar um reset antecipado. A cota é rastreada por projeto, não por chave de API, então gerar uma segunda chave a partir do mesmo projeto não te dá um segundo pool.

Cada chamada de API custa unidades, não requisições - e os custos são desiguais. Aqui está o panorama completo entre os endpoints que os desenvolvedores realmente usam:

A 100 unidades por busca, um projeto pode esgotar toda a sua cota diária depois de apenas 100 chamadas de busca - antes de baixar uma única legenda. Esta é a forma mais comum de projetos pequenos atingirem o limite: eles não fizeram 10.000 requisições, fizeram algumas centenas de chamadas caras. Em contrapartida, videos.list, channels.list, e playlistItems.list são baratas, a 1 unidade cada - se você já sabe o ID de um vídeo, canal ou playlist, essas chamadas mal arranham o orçamento diário.

1. Abra o Google Cloud Console para o projeto vinculado à sua chave de API.
2. Vá em APIs & Services → YouTube Data API v3 → Quotas & System Limits.
3. Isso mostra seu uso atual em relação a Queries per day e aos limites por minuto, atualizado com um pequeno atraso em vez de em tempo real.

Se você já está perto do teto antes de ter feito 10.000 requisições, essa visualização é como você confirma que é o problema das chamadas caras acima, e não um bug.

Ambos retornam um 403, e ambos são agrupados casualmente como "erros de cota", mas são problemas diferentes com soluções diferentes:

• quotaExceeded (motivo: dailyLimitExceeded) - seu projeto usou toda a sua alocação diária de unidades. Nada resolve isso, exceto esperar o reset à meia-noite no horário do Pacífico, reduzir o custo por chamada, ou conseguir aprovação para um aumento de cota.
• rateLimitExceeded - você está enviando requisições rápido demais em uma janela curta, independente do seu total diário. Isso é um problema de ritmo, não de orçamento - veja nosso guia de limite de taxa para tratar isso corretamente com backoff.

1. Armazene em cache agressivamente. A cota é cobrada por chamada de API, não por requisição do usuário final - se você buscar de novo as legendas do mesmo vídeo repetidamente, armazene o resultado em cache (mesmo um simples cache TTL em memória) em vez de chamar a API de novo para dados que não mudam de minuto a minuto.
2. Evite search.list onde uma busca direta por ID funciona. Se você já tem um ID de vídeo, canal ou playlist, a chamada .list correspondente custa 100 vezes menos do que uma busca.
3. Agrupe buscas por ID. videos.list aceita até 50 IDs separados por vírgula por chamada, pelo mesmo custo de 1 unidade de um único ID - buscar 50 vídeos um por um em vez de agrupados é 50 vezes mais caro sem motivo.
4. Solicite um aumento de cota assim que tiver uso real em produção para justificá-lo, através do formulário YouTube API Services Audit and Quota Extension, disponível na página de cota do Cloud Console. Espere uma revisão manual, não uma aprovação instantânea.
5. Use uma API de transcrição que não passe pela sua própria cota do YouTube. A API do GetYouTubeTranscript busca transcrições contra sua própria infraestrutura em vez de fazer proxy de captions.download com sua chave, então não há um teto diário de 10.000 unidades para gerenciar - apenas o limite de taxa de requisições do próprio plano.

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"])

Isso custa 1 crédito contra seu plano do GetYouTubeTranscript, não unidades contra a cota da YouTube Data API do seu projeto no Google Cloud. Obtenha 100 créditos grátis, sem cartão necessário, no painel, ou veja a documentação completa da API.