Kuota untuk Layanan Google

Layanan Google Apps Script memiliki kuota harian dan batasan pada beberapa fitur. Jika Anda melebihi kuota atau batasan, skrip Anda akan menampilkan pengecualian dan eksekusi akan berhenti.

Beberapa fitur memiliki kuota tambahan dari produk Google terkait. Penggunaan layanan Apps Script produk akan dihitung dalam semua reservasi kuota terkait. Fitur menjadi tidak tersedia jika Anda mencapai kuota terkait.

Kuota saat ini

Kuota ditetapkan di berbagai tingkat untuk pengguna akun konsumen (seperti gmail.com) dan akun Google Workspace. Kuota per pengguna dan direset 24 jam setelah permintaan pertama.

Gunakan kuota berikut untuk membantu menguji skrip Anda. Semua kuota dapat dihapus, dikurangi, atau diubah kapan saja, tanpa pemberitahuan.

Fitur Akun konsumen (misalnya, gmail.com) Akun Google Workspace
Acara kalender yang dapat dibuat 5.000 / hari 10.000 / hari
Kontak yang dapat dibuat 1.000 / hari 2.000 / hari
Dokumen yang dapat dibuat 250 / hari 1.500 / hari
File dikonversi 2.000 / hari 4.000 / hari
Penerima email per hari (misalnya, dengan MailApp) 100* / hari 1.500* / hari
Penerima email per hari dalam domain (misalnya, dengan MailApp) 100* / hari 2.000 / hari
Baca/tulis email (tidak termasuk kirim) 20.000 / hari 50.000 / hari
Grup yang dapat dibaca 2.000 / hari 10.000 / hari
Sambungan JDBC 10.000 / hari 50.000 / hari
Sambungan gagal JDBC 100 / hari 500 / hari
Presentasi dibuat 250 / hari 1.500 / hari
Properti baca/tulis 50.000 / hari 500.000 / hari
Slide dibuat 250 / hari 1.500 / hari
Spreadsheet yang dapat dibuat 250 / hari 3.200 / hari
Waktu proses total pemicu 90 menit / hari 6 jam / hari
Panggilan Pengambilan URL 20.000 / hari 100.000 / hari
Rendering Peta Statis 1.000 / hari 10.000 / hari
Kueri Arah Google Maps 1.000 / hari 10.000 / hari
Panggilan Geocode Google Maps 1.000 / hari 10.000 / hari
Menerjemahkan panggilan 5.000 / hari 20.000 / hari
Kueri contoh elevasi Google Maps 1.000 / hari 10.000 / hari
Project Apps Script 50 / hari 50 / hari

Batas tambahan berlaku untuk akun uji coba. Setelah Anda beralih dari akun uji coba gratis ke langganan berbayar, batas akun Anda akan otomatis ditingkatkan jika kedua hal berikut terpenuhi:

  • Domain Anda telah membayar minimal USD $100 (atau setara) secara kumulatif.
  • Setidaknya 60 hari telah berlalu sejak nilai minimum pembayaran tercapai.

Batasan saat ini

Gunakan batas berikut untuk membantu menguji skrip Anda. Semua batas dapat dihapus, dikurangi, atau diubah kapan saja, tanpa pemberitahuan.

Fitur Akun konsumen (misalnya, gmail.com) Akun Google Workspace
Waktu proses skrip 6 menit / eksekusi 6 menit / eksekusi
Runtime fungsi kustom 30 dtk / eksekusi 30 dtk / eksekusi
Runtime add-on Google Workspace 30 dtk / eksekusi 30 dtk* / eksekusi
Eksekusi serentak per pengguna 30 / pengguna 30 / pengguna
Eksekusi simultan per skrip 1.000 1.000
Lampiran email 250 / psn 250 / psn
Ukuran isi email 200 KB / pesan 400 KB / pesan
Penerima email per pesan 50 / psn 50 / psn
Ukuran lampiran total email 25 MB / pesan 25 MB / pesan
Ukuran nilai properti 9 KB / val 9 KB / val
Total penyimpanan properti 500 KB / toko properti 500 KB / toko properti
Pemicu 20 / pengguna / skrip 20 / pengguna / skrip
Ukuran respons URL Fetch 50 MB / panggilan 50 MB / panggilan
Header URL Fetch 100 / panggilan 100 / panggilan
Ukuran header Pengambilan URL 8 KB / panggilan 8 KB / panggilan
Ukuran POST Pengambilan URL 50 MB / panggilan 50 MB / panggilan
Panjang URL URL Fetch 2 KB / panggilan 2 KB / panggilan
Versi 200 / script 200 / script

Memantau penggunaan kuota

Untuk memantau konsumsi kuota dan kesehatan eksekusi skrip, gunakan metode berikut:

  • Kuota email: Gunakan MailApp.getRemainingDailyQuota() untuk memeriksa jumlah penerima email yang tersisa yang dapat Anda kirimi email untuk sisa hari ini.
  • Pemantauan eksekusi: Gunakan dasbor Apps Script untuk melihat riwayat eksekusi dan kondisi skrip Anda. Halaman Eksekusi Saya menampilkan status (misalnya, Completed, Failed, atau Running) setiap eksekusi skrip. Anda dapat memantau jumlah eksekusi serentak dengan memfilter eksekusi dengan Status Running.
  • Konsol Google Cloud: Jika project Apps Script Anda menggunakan project Google Cloud standar, Anda dapat memantau kuota khusus layanan dan penggunaan API di konsol Google Cloud.

Pesan pengecualian

Jika skrip mencapai kuota atau batasan, skrip akan menampilkan pengecualian dengan pesan yang mirip dengan berikut ini:

  • Limit exceeded: Email Attachments Per Message. Hal ini menunjukkan bahwa skrip melampaui salah satu kuota atau batasan yang tercantum di bagian Kuota saat ini atau Batasan saat ini.
  • Service invoked too many times: Calendar. Hal ini menunjukkan bahwa skrip memanggil layanan tertentu terlalu sering dalam satu hari.
  • Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls. Hal ini menunjukkan bahwa skrip memanggil layanan tertentu terlalu sering dalam waktu singkat.
  • Service using too much computer time for one day. Hal ini menunjukkan bahwa skrip melampaui total waktu eksekusi yang diizinkan selama satu hari. Error ini paling sering terjadi pada skrip yang berjalan di pemicu, yang memiliki batas harian lebih rendah daripada skrip yang dijalankan secara manual.
  • Script invoked too many times per second for this Google user account. Hal ini menunjukkan bahwa skrip mulai dieksekusi terlalu sering dalam waktu singkat. Error ini paling sering terjadi pada fungsi kustom yang dipanggil berulang kali dalam satu spreadsheet. Untuk menghindari error ini, kode fungsi kustom Anda sehingga hanya perlu dipanggil satu kali per rentang data, seperti yang dijelaskan dalam panduan fungsi kustom.
  • There are too many scripts running simultaneously for this Google user account. Hal ini menunjukkan bahwa Anda memiliki terlalu banyak skrip yang dijalankan sekaligus, meskipun tidak harus skrip yang sama. Seperti pengecualian sebelumnya, pengecualian ini paling sering terjadi untuk fungsi kustom yang dipanggil berulang kali dalam satu spreadsheet.