YouTube Data API feltöltési kvóta: külön keretek 2026-ban

A YouTube API feltöltési kapacitását ma már nem úgy kell kiszámolni, hogy az általános napi kvótát elosztod egy régi feltöltési egységköltséggel. A 2026-10-17-én ellenőrzött hivatalos API-referencia szerint a videófeltöltések önálló alapértelmezett keretet kaptak: napi 100 hívást, amelyből minden egyes feltöltés 1 egységet fogyaszt a Video Uploads gyűjtőben (bucketben). Mielőtt konkrét kézbesítési kapacitást ígérnél, mindig ellenőrizd a saját Google Cloud projektedhez ténylegesen hozzárendelt kvótát.

A tágabb tartalomgyártási folyamathoz érdemes az egy videó előkészítése Shortsra, TikTokra és Reelsre című útmutatónkkal kezdeni. Ez a cikk a megfelelő médiafájlok elkészülte utáni API-kapacitástervezéssel foglalkozik, nem pedig magukkal a videó-specifikációkkal.

Használd az aktuális kvótagyűjtőket (quota buckets)

A 2026-10-17-én ellenőrzött YouTube Data API áttekintő dokumentáció három különálló alapértelmezett napi keretet dokumentál: napi 100 videófeltöltési hívást (Video Uploads), napi 100 keresési hívást (Search), valamint 10 000 egységet az összes többi végpontra (Other endpoints). Ezek Google Cloud projektszintű keretek: a rendelkezésre álló mennyiség nem szorzódik fel a munkaterületre bekötött YouTube-csatornák számával.

A 2026-10-17-én ellenőrzött hivatalos kvótakalkulátor rögzíti, hogy a napi kvóták csendes-óceáni idő (Pacific Time) szerint éjfélkor nullázódnak. Ha az ütemezőrendszered európai vagy más időzónában fut, a helyi naptári éjfél nem esik egybe a Google kvóta-visszaállítási határával, így a napi keret tervezésekor mindig a csendes-óceáni időzóna szerinti fordulópontot kell figyelembe venni.

A korábbi évekből származó költségpéldákat mindig dátumhoz kötve kell értelmezni. A hivatalos változástörténet (revision history) szerint a videófeltöltés egységköltsége 2025-12-04-én körülbelül 1 600 egységről körülbelül 100 egységre csökkent, majd 2026-06-01-jén életbe léptek a különálló feltöltési és keresési kvótagyűjtők. Ha akár az 1 600-as, akár a 100-as korábbi egységköltséget vonod le a mai 10 000 egységes általános keretből, hibás kapacitásmodellt kapsz.

Számold össze a feltöltést körülvevő kísérőműveleteket is

A saját YouTube-feltöltőmodulunk 2026-10-17-i forráskód-ellenőrzése megmutatta, hogy a rendszer először meghívja a videos.insert végpontot a videó létrehozásához, majd ha a kéréshez egyedi indexkép (thumbnail) útvonal is tartozik, külön meghívja a thumbnails.set műveletet. Ez két önálló API-hívás, amelyek két különböző kvótagyűjtőt terhelnek. A 2026-10-17-én ellenőrzött kvótakalkulátor szerint az indexkép-frissítés (thumbnails.set) 50 egységbe, míg a videos.list lekérdezés 1 egységbe kerül, és mindkettő az „egyéb végpontok” (10 000 egységes) keretét fogyasztja, nem pedig a Video Uploads gyűjtőt.

Ezt a szemléltető számítást 2026-10-17-én Node.js szkripttel és automatikus ellenőrzésekkel (assertions) futtattuk le. Ha érintetlen alapértelmezett napi keretekből indulunk ki, a fenti 75 videós csomag után 25 feltöltési egység (100 mínusz 75) és 6 175 egyéb végponti egység (10 000 mínusz 3 825) marad szabadon. Ez a számítás nem tartalmazza az esetleges újrapróbálkozásokat (retries), a további státuszlekérdezéseket és az alkalmazás egyéb YouTube API-forgalmát (például csatornalistázást vagy analitikai olvasásokat). Ez egy tervezési segédszámítás: nem egy éles Google Cloud projekt fennmaradó kvótájának mérése, és nem garancia arra, hogy minden egyes feltöltés sikeresen lefut.

Kezeld külön a termékszintű limiteket a Google kvótájától

A forráskód-áttekintés során megvizsgáltuk az alkalmazásunk saját rate-limit middleware-ét is, amely munkaterületi szinten korlátozza a beérkező API-kérések számát. Ezek a számlálók a saját szerverünkre érkező HTTP-hívásokat mérik (például amikor elindítasz egy munkát a videópublikálási API-útmutatóban leírt végponton), és semmilyen formában nem mutatják meg, hány YouTube-feltöltési egység maradt szabadon a Google Cloud projektben.

A cikkhez áttekintett belső publikálási kvótakapu (publishQuotaGate) kifejezetten Instagram-specifikus kvótaellenőrzéseket valósít meg, és nem kérdez le YouTube-kvótaszámlálót a Google-től. Emiatt az alkalmazás nem ígér valós idejű YouTube fennmaradókvóta-kijelzést vagy a Google feltöltési keretének előzetes, automatikus lefoglalását. A projektedhez ténylegesen hozzárendelt limiteket és az aktuális kihasználtságot mindig közvetlenül a Google Cloud Console kvótafelületén kell ellenőrizni.

A csatlakoztatott csatorna kezelésének termékkörnyezetét a YouTube publikálási csatorna oldalunk mutatja be. A beküldés előtt ellenőrizd magát a médiafájlt a videó-specifikáció ellenőrző eszközzel — de tartsd szem előtt, hogy a sikeres fájlellenőrzés még nem foglal le YouTube API-kvótát.

Olvasd ki a pontos hibaokot az újrapróbálkozás előtt

A 2026-10-17-én ellenőrzött videos.insert referencia dokumentálja az uploadLimitExceeded hibakódot arra az esetre, amikor a feltöltő felhasználó túl sok videót töltött fel. Soha ne vond le ebből automatikusan azt a következtetést, hogy a Google Cloud projekt napi API-kvótája fogyott el: egy adott YouTube-csatornára vonatkozó napi feltöltési korlátozás és egy projektszintű API-kvótakimerülés teljesen eltérő hibaelhárítást igényel.

A vizsgált feltöltőmodulunk megőrzi a Google által visszaadott, géppel olvasható hibaokot (reason), amikor becsomagolja a sikertelen beszúrási hibát. A helyi hibataxonómia (platformErrorTaxonomy) az újrapróbálkozási szabályzat (retry policy) céljából egy csoportba sorolja a kvóta- és rate-limit jellegű okokat, de ez a belső csoportosítás önmagában nem bizonyítja, hogy melyik külső keret telt be, vagy hogy mikor oldódik fel egy csatornaszintű korlátozás. A diagnosztikában mindig őrizd meg az eredeti Google-hibaokot, a végrehajtott műveletet és a célfiók azonosítóját.

Egy sikertelen indexkép-beállítás (thumbnails.set) szintén alapvetően különbözik egy sikertelen videóbeszúrástól (videos.insert). Az áttekintett feltöltőben az indexkép-feltöltési hiba naplózása akkor történik meg, amikor maga a videó már létrejött a YouTube-on. Ha pusztán az indexkép javítása miatt újra lefuttatod a teljes videófeltöltést, azzal egy második, duplikált videót hozhatsz létre a csatornán és újabb egységet égetsz el a Video Uploads keretből. Bármilyen bizonytalan vagy részleges hiba után először ellenőrizd a már létrejött eredményt, mielőtt újabb videos.insert hívást indítanál.

Tervezd a kapacitást a ténylegesen üzemeltetett projekted alapján

Készíts külön leltárt a várható napi videófeltöltésekről, az indexkép-módosításokról, a metaadat-frissítésekről és a státuszlekérdezésekről. Vesd össze ezeket a becsléseket a Google Cloud projektedben ténylegesen engedélyezett limitekkel és a megfigyelt napi forgalommal, és mindig hagyj biztonsági tartalékot az egyéb API-hívásoknak ahelyett, hogy az elméleti maximumot garantált kézbesítési ígéretként kezelnéd.

A Google 2026-10-17-én ellenőrzött kvóta- és megfelelőségi audit útmutatója ismerteti a hivatalos folyamatot arra az esetre, ha az alapértelmezettnél magasabb kvótakeretet szeretnél igényelni. Ez a cikk nem közöl állítást az Uplonic saját Google-kvótáiról, semmilyen auditeljárás kimeneteléről vagy éles feltöltési áteresztőképességről; ezek megállapításához mindig az adott Google Cloud projekthez való hozzáférésre és felhatalmazott üzemi mérésre van szükség.