Batas & Kuota Google Apps Script yang Wajib Diketahui (dan Cara Menyiasatinya)

Google Apps Script gratis, tapi bukan tanpa batas. Kalau kamu pernah kena error 'Exceeded maximum execution time' atau tiba-tiba UrlFetch berhenti bekerja di sore hari, kemungkinan kamu menabrak salah satu batas berikut. Pahami dari awal supaya arsitekturmu tidak salah sejak desain.

1. Batas eksekusi 6 menit

Satu kali jalan fungsi dibatasi sekitar 6 menit (akun gratis). Ini paling sering kena saat memproses ribuan baris. Siasati dengan: baca/tulis borongan (getValues/setValues) alih-alih per sel, dan untuk pekerjaan panjang pecah jadi beberapa sesi pakai trigger terjadwal yang menyimpan posisi terakhir (continuation) di Script Properties.

2. Kuota UrlFetch harian

Panggilan ke API luar (UrlFetchApp) punya jatah harian (di akun gratis ordernya puluhan ribu per hari). Kalau aplikasimu memanggil API tiap baris tiap menit, jatah bisa cepat habis. Siasati dengan cache (CacheService) untuk data yang jarang berubah, dan gabungkan permintaan bila API-nya mendukung batch.

3. Total runtime trigger per hari

Semua trigger (terjadwal/onEdit) berbagi jatah total waktu jalan per hari (akun gratis ordernya puluhan menit sampai beberapa jam). Trigger tiap menit yang berat bisa menghabiskannya. Siasati dengan mengurangi frekuensi trigger dan membuat setiap jalannya seringkas mungkin.

4. Operasi Spreadsheet

Tiap getValue()/setValue() ke satu sel adalah panggilan mahal. Loop ribuan sel = lambat + boros waktu eksekusi. Selalu baca satu range besar sekali (getValues), olah di memori (array JavaScript), lalu tulis balik sekali (setValues).

Kunci: pikirkan batas sejak merancang

Batas-batas ini paling murah diatasi di tahap desain, bukan setelah aplikasi jadi dan lambat. Mode Web GAS di Skematik menyusun PRD yang konvensinya sudah sadar batasan Apps Script (batch I/O, LockService, batas 6 menit, mode deploy) — jadi AI coding agent-mu membangunnya dengan pola yang benar sejak awal.