YouTube API Quota Exceeded: Causes and Fixes

Her Google Cloud projesi, gece yarısı Pasifik saatinde sıfırlanan varsayılan bir YouTube Data API v3 kotasına günde 10.000 birim alır - devretme yoktur ve erken bir sıfırlamayı tetiklemenin bir yolu yoktur. Kota, API anahtarı başına değil, proje başına takip edilir, bu yüzden aynı projeden ikinci bir anahtar üretmek size ikinci bir havuz vermez.

Her API çağrısı isteklere değil birimlere mal olur - ve maliyetler dengesizdir. İşte geliştiricilerin gerçekten kullandığı uç noktalar genelindeki tam tablo:

Arama başına 100 birimle, bir proje tek bir altyazı indirilmeden önce, sadece 100 arama çağrısından sonra tüm günlük kotasını tüketebilir. Küçük projelerin sınıra takılmasının en yaygın yolu tam olarak budur: 10.000 istek yapmadılar, birkaç yüz pahalı çağrı yaptılar. Buna karşılık, videos.list, channels.list ve playlistItems.list her biri 1 birimle ucuzdur - zaten bir video, kanal veya çalma listesi ID'si biliyorsanız, bu çağrılar günlük bütçeyi zar zor eritir.

1. API anahtarınıza bağlı proje için Google Cloud Console'u açın.
2. APIs & Services → YouTube Data API v3 → Quotas & System Limits'e gidin.
3. Bu, gerçek zamanlı değil kısa bir gecikmeyle güncellenen, Queries per day ve dakika başına sınırlara karşı mevcut kullanımınızı gösterir.

10.000 istek yapmadan önce zaten tavana yakınsanız, bu görünüm bunun yukarıdaki pahalı çağrı sorunu olduğunu, bir hata olmadığını doğrulamanızın yoludur.

İkisi de 403 döndürür ve günlük konuşmada ikisi de "kota hataları" olarak bir araya toplanır, ancak farklı düzeltmeleri olan farklı sorunlardır:

• quotaExceeded (neden: dailyLimitExceeded) - projeniz tam günlük birim tahsisini kullandı. Gece yarısı Pasifik sıfırlamasını beklemek, çağrı başına maliyeti azaltmak veya onaylı bir kota artışı almak dışında hiçbir şey bunu düzeltmez.
• rateLimitExceeded - günlük toplamınızdan bağımsız olarak, kısa bir pencerede çok hızlı istek gönderiyorsunuz. Bu bir bütçe sorunu değil, bir hız ayarı sorunudur - bunu geri çekilme ile doğru şekilde nasıl ele alacağınız için hız sınırı rehberimize bakın.

1. Agresif bir şekilde önbelleğe alın. Kota, kullanıcıya yönelik istek başına değil, API çağrısı başına ücretlendirilir - aynı videonun altyazılarını tekrar tekrar yeniden alıyorsanız, dakikadan dakikaya değişmeyen veriler için API'yi tekrar çağırmak yerine sonucu (basit bir bellek içi TTL önbelleği bile) önbelleğe alın.
2. Doğrudan bir ID araması işe yaradığında search.list'ten kaçının. Zaten bir video, kanal veya çalma listesi ID'niz varsa, karşılık gelen .list çağrısı bir aramadan 100 kat daha ucuzdur.
3. ID aramalarını toplu yapın. videos.list, tek bir ID ile aynı 1 birimlik maliyet karşılığında çağrı başına 50'ye kadar virgülle ayrılmış ID kabul eder - 50 videoyu toplu yerine tek tek almak, hiçbir sebep olmadan 50 kat daha pahalıdır.
4. Bir kota artışı isteyin, gerçek üretim kullanımınız buna gerekçe olduğunda, Cloud Console'un kota sayfasından bağlantı verilen YouTube API Services Denetimi ve Kota Uzatma formu üzerinden. Anında onay değil, manuel bir inceleme bekleyin.
5. Kendi YouTube kotanız üzerinden çalışmayan bir transkript API'si kullanın. GetYouTubeTranscript'in API'si, captions.download'u sizin anahtarınızla proxy'lemek yerine transkriptleri kendi altyapısına karşı alır, bu yüzden yönetilecek 10.000 birimlik bir günlük tavan yoktur - yalnızca planın kendi istek hızı sınırı vardır.

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

Bu, Google Cloud projenizin YouTube Data API kotasına karşı birim değil, GetYouTubeTranscript planınıza karşı 1 kredi harcar. Panelden kart gerekmeden 100 ücretsiz kredi alın veya tam API dokümanlarına bakın.