YouTube API Quota Exceeded: Causes and Fixes

Каждый проект Google Cloud получает стандартную квоту YouTube Data API v3 в размере 10 000 единиц в день, которая сбрасывается в полночь по тихоокеанскому времени — переноса остатка нет, и досрочный сброс запустить нельзя. Квота отслеживается по проекту, а не по API-ключу, поэтому создание второго ключа в том же проекте не даёт второй пул.

Каждый вызов API стоит единицы, а не запросы — и стоимость неравномерна. Вот полная картина по эндпоинтам, которые реально используют разработчики:

При 100 единицах за один поиск проект может исчерпать всю суточную квоту всего за 100 вызовов поиска — ещё до того, как будут скачаны какие-либо субтитры. Это самый распространённый способ, которым небольшие проекты упираются в лимит: они сделали не 10 000 запросов, а несколько сотен дорогих. Для сравнения, videos.list, channels.list и playlistItems.list дёшевы — по 1 единице каждый: если вы уже знаете ID видео, канала или плейлиста, эти вызовы почти не расходуют суточный бюджет.

1. Откройте Google Cloud Console для проекта, привязанного к вашему API-ключу.
2. Перейдите в APIs & Services → YouTube Data API v3 → Quotas & System Limits.
3. Здесь показано текущее использование относительно Queries per day и лимитов в минуту, обновляемое с небольшой задержкой, а не в реальном времени.

Если вы уже близки к потолку, не сделав 10 000 запросов, этот раздел позволяет подтвердить, что дело именно в проблеме дорогих вызовов выше, а не в ошибке.

Оба возвращают код 403, и в неформальном разговоре их часто объединяют как «ошибки квоты», но это разные проблемы с разными решениями:

• quotaExceeded (причина: dailyLimitExceeded) — ваш проект израсходовал всю суточную квоту единиц. Ничего не помогает, кроме ожидания сброса в полночь по тихоокеанскому времени, снижения стоимости вызова или получения одобренного увеличения квоты.
• rateLimitExceeded — вы отправляете запросы слишком быстро в коротком временном окне, независимо от вашей суточной суммы. Это проблема темпа, а не бюджета — см. наше руководство по лимиту частоты запросов, чтобы узнать, как правильно с ней справиться с помощью отката.

1. Кэшируйте агрессивно. Квота списывается за каждый вызов API, а не за каждый запрос пользователя — если вы многократно повторно запрашиваете субтитры одного и того же видео, кэшируйте результат (даже простой TTL-кэш в памяти) вместо повторного вызова API за данными, которые не меняются каждую минуту.
2. Избегайте search.list там, где подходит прямой поиск по ID. Если у вас уже есть ID видео, канала или плейлиста, соответствующий вызов .list в 100 раз дешевле поиска.
3. Группируйте запросы по ID. videos.list принимает до 50 ID, разделённых запятыми, за один вызов по той же цене в 1 единицу, что и один ID — получать 50 видео по одному вместо пакетного запроса обходится в 50 раз дороже без всякой причины.
4. Запросите увеличение квоты, как только у вас появится реальное продакшен-использование, которое это обосновывает, через форму YouTube API Services Audit and Quota Extension, доступную со страницы квоты в Cloud Console. Ожидайте ручной проверки, а не мгновенного одобрения.
5. Используйте API транскриптов, который не расходует вашу собственную квоту YouTube. API GetYouTubeTranscript получает транскрипты через собственную инфраструктуру, а не проксирует captions.download вашим ключом, поэтому суточного потолка в 10 000 единиц отслеживать не нужно — только собственный лимит частоты запросов вашего тарифа.

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

Это стоит 1 кредит по вашему тарифу GetYouTubeTranscript, а не единицы квоты YouTube Data API вашего проекта Google Cloud. Получите 100 бесплатных кредитов без карты в панели управления, или посмотрите полную документацию API.