YouTube API kotası nedir? Limitler, maliyetler ve kota dolarsa ne yapılır?

YouTube'a yazılım aracılığıyla bağlanan her uygulama, YouTube Data API kotasına tabidir. Kota, bir Google Cloud projesinin günde yapabileceği işlem miktarını sınırlar. Otomasyon araçlarında “kota aşıldı” hatası, videoların yüklenmemesinin en sık nedenlerinden biridir; bu yüzden nasıl çalıştığını bilmek işe yarar.

Varsayılan kota

Google'ın belgesine göre YouTube Data API'yi etkinleştiren projeler varsayılan olarak şunları alır: günde 100 search.list çağrısı, günde 100 videos.insert (video yükleme) çağrısı ve diğer tüm uç noktalar için günlük ortak 10.000 birim (YouTube Data API belgesi). Yani arama ve video yükleme ayrı kovalarda, diğer işlemler ise 10.000 birimlik ortak havuzda sayılır.

Eski kaynaklarda yükleme başına çok yüksek bir birim maliyeti yazılabilir; güncel resmî belgeye göre yükleme, kendi kovasında 1 birim sayılır ve kova günlük 100 çağrıyla sınırlıdır. Güncel değerleri her zaman Google'ın belgesinden kontrol edin.

İşlemlerin birim maliyeti

YouTube'un genel kuralı: bir listeyi okumak genellikle 1 birim, kaynak oluşturmak, güncellemek ya da silmek genellikle 50 birimdir. Belgede öne çıkan örnekler (kota maliyet tablosu):

YouTube Analytics API ve Reporting API'nin kendi kotaları ayrıdır; belgelerine bakın.

Kota ne zaman sıfırlanır?

Google'a göre günlük kotalar Pasifik saatiyle (PT) gece yarısı sıfırlanır. Türkiye'de saat dilimi sabit olduğu için bu:

• ABD yaz saati uygulaması sürerken (Mart ortasından Kasım başına kadar): 10:00,
• ABD kış saatinde (Kasım başından Mart ortasına kadar): 11:00.

Kotayı verimli kullanmanın yolları

1. Aramadan kaçının. Bir kanalın yüklemelerini listelemek için search.list yerine kanalın “yüklemeler” oynatma listesini playlistItems.list ile okuyun; çok daha ucuzdur.
2. Toplu okuyun. videos.list tek çağrıda 50 video kimliğine kadar sorgulayabilir.
3. Önbellek kullanın. Aynı veriyi kısa sürede tekrar sormayın; analitik panellerini birkaç dakikada bir yenilemek yeterlidir.
4. Gereksiz güncellemeden kaçının. Başlık ve küçük resmi yükleme sırasında doğru girin; sonradan düzeltmek 50 birimden fazlasına mal olur.
5. Hataya göre bekleyin. quotaExceeded alındığında art arda yeniden denemek işe yaramaz; sıfırlanmayı bekleyin.
6. Yüklemeyi planlayın. Günlük 100 yükleme çoğu kanal için fazlasıyla yeterlidir; sıkışma yaşayan projelerde asıl darboğaz çoğu zaman diğer işlemlerin ortak 10.000 birimi olabilir.

Kota dolduğunda ne olur?

API, quotaExceeded hatası döndürür; kota sıfırlanana kadar aynı türde işlemler reddedilir. İyi bir otomasyon aracı bunu şöyle yönetir: hatayı kullanıcıya gösterir, işlemi kuyruğa alır, kota açıldığında kaldığı yerden devam eder ve panelde son bilinen verileri gösterir. Bu davranışı olmayan bir araç, kota dolunca üretimi durdurabilir (araç seçme ölçütleri).

Daha fazla kota nasıl alınır?

Google, varsayılan kotayı aşan projeler için bir kota uzatma formu sunar; ancak başvurudan önce projenizin YouTube API Hizmetleri Kullanım Şartları'na uyumunu gösteren bir uyumluluk denetimi gerekir (Kota ve uyumluluk denetimleri). Aynı denetim, yeni API projelerinden yüklenen videoların özel kalması kuralını kaldırmak için de gereklidir (otomatik yükleme rehberi).

Kendi projenizi mi kullanmalısınız?

Bir otomasyon aracı kendi API projesini ve OAuth istemcisini kullanır; kotayı da bu projeden harcar. Araç ortak bir proje kullanıyorsa kota, o projeyi kullanan herkesin ortak sınırıdır; bu yüzden aracın kota yönetimi ve iş modeli önemlidir.

Mecra ve kota

Mecra, YouTube'a yaptığı çağrıları verimli tutmak için son yanıtları bir süre önbelleğe alır ve kota dolarsa panelde son bilinen verileri gösterip sıfırlanma sonrasında yükleme ve yenilemeye kendiliğinden devam eder. Günlük limitleri (yapay zekâ, YouTube API, disk) Kayıtlar sayfasında görebilirsiniz.

Kaynaklar

• YouTube Data API: başlangıç ve kota
• Kota maliyetlerini belirleme (YouTube Data API)
• Kota ve uyumluluk denetimleri (YouTube Data API)