Batas penggunaan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Gmail API tunduk pada batas penggunaan yang membatasi kecepatan pemanggilan metode API. Batas ditentukan dalam unit kuota , yaitu unit pengukuran abstrak yang merepresentasikan penggunaan resource Gmail. Ada dua batas penggunaan yang diterapkan secara bersamaan: batas penggunaan per project dan batas penggunaan per pengguna. Tabel
berikut menjelaskan batas penggunaan ini:
Jenis batas penggunaan
Batas
Alasan melampaui
Batas frekuensi panggilan per project
1.200.000 unit kuota per menit
rateLimitExceeded
Batas kapasitas per pengguna
15.000 unit kuota per pengguna per menit
userRateLimitExceeded
Catatan: Untuk mengetahui informasi tentang penanganan error batas, lihat Mengatasi error . Penggunaan kuota per metode
Jumlah unit kuota yang digunakan oleh permintaan bervariasi, bergantung pada metode yang dipanggil. Tabel berikut menguraikan penggunaan unit kuota per metode:
Metode
Unit Kuota
drafts.create10
drafts.delete10
drafts.get5
drafts.list5
drafts.send100
drafts.update15
getProfile1
history.list2
labels.create5
labels.delete5
labels.get1
labels.list1
labels.update5
messages.attachments.get5
messages.batchDelete50
messages.batchModify50
messages.delete10
messages.get5
messages.import25
messages.insert25
messages.list5
messages.modify5
messages.send100
messages.trash5
messages.untrash5
settings.delegates.create100
settings.delegates.delete5
settings.delegates.get1
settings.delegates.list1
settings.filters.create5
settings.filters.delete5
settings.filters.get1
settings.filters.list1
settings.forwardingAddresses.create100
settings.forwardingAddresses.delete5
settings.forwardingAddresses.get1
settings.forwardingAddresses.list1
settings.getAutoForwarding1
settings.getImap1
settings.getPop1
settings.getVacation1
settings.sendAs.create100
settings.sendAs.delete5
settings.sendAs.get1
settings.sendAs.list1
settings.sendAs.update100
settings.sendAs.verify100
settings.updateAutoForwarding5
settings.updateImap5
settings.updatePop100
settings.updateVacation5
stop50
threads.delete20
threads.get10
threads.list10
threads.modify10
threads.trash10
threads.untrash10
watch100
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0 , sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0 . Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers . Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[],[],null,["# Usage limits\n\nThe Gmail API is subject to usage limits which restrict the rate at which\nmethods of the API can be called. Limits are defined in terms of [quota\nunits](#per-method_quota_usage), an abstract unit of measurement representing\nGmail resource usage. There are two usage limits which are applied\nsimultaneously: a per project usage limit and a per user usage limit. The\nfollowing table details these usage limits:\n\n| Usage limit type | Limit | Exceeded reason |\n|------------------------|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| Per project rate limit | 1,200,000 quota units per minute | [rateLimitExceeded](https://developers.google.com/workspace/gmail/api/guides/handle-errors#resolve_a_403_error_rate_limit_exceeded) |\n| Per user rate limit | 15,000 quota units per user per minute | [userRateLimitExceeded](https://developers.google.com/workspace/gmail/api/guides/handle-errors#resolve_a_403_error_user_rate_limit_exceeded) |\n\n| **Note:** For information on handling limit errors, refer to [Resolve\n| errors](/workspace/gmail/api/guides/handle-errors).\n\nPer-method quota usage\n----------------------\n\nThe number of quota units consumed by a request varies depending on the method\ncalled. The following table outlines the per-method quota unit usage:\n\n| Method | Quota Units |\n|---------------------------------------|-------------|\n| `drafts.create` | 10 |\n| `drafts.delete` | 10 |\n| `drafts.get` | 5 |\n| `drafts.list` | 5 |\n| `drafts.send` | 100 |\n| `drafts.update` | 15 |\n| `getProfile` | 1 |\n| `history.list` | 2 |\n| `labels.create` | 5 |\n| `labels.delete` | 5 |\n| `labels.get` | 1 |\n| `labels.list` | 1 |\n| `labels.update` | 5 |\n| `messages.attachments.get` | 5 |\n| `messages.batchDelete` | 50 |\n| `messages.batchModify` | 50 |\n| `messages.delete` | 10 |\n| `messages.get` | 5 |\n| `messages.import` | 25 |\n| `messages.insert` | 25 |\n| `messages.list` | 5 |\n| `messages.modify` | 5 |\n| `messages.send` | 100 |\n| `messages.trash` | 5 |\n| `messages.untrash` | 5 |\n| `settings.delegates.create` | 100 |\n| `settings.delegates.delete` | 5 |\n| `settings.delegates.get` | 1 |\n| `settings.delegates.list` | 1 |\n| `settings.filters.create` | 5 |\n| `settings.filters.delete` | 5 |\n| `settings.filters.get` | 1 |\n| `settings.filters.list` | 1 |\n| `settings.forwardingAddresses.create` | 100 |\n| `settings.forwardingAddresses.delete` | 5 |\n| `settings.forwardingAddresses.get` | 1 |\n| `settings.forwardingAddresses.list` | 1 |\n| `settings.getAutoForwarding` | 1 |\n| `settings.getImap` | 1 |\n| `settings.getPop` | 1 |\n| `settings.getVacation` | 1 |\n| `settings.sendAs.create` | 100 |\n| `settings.sendAs.delete` | 5 |\n| `settings.sendAs.get` | 1 |\n| `settings.sendAs.list` | 1 |\n| `settings.sendAs.update` | 100 |\n| `settings.sendAs.verify` | 100 |\n| `settings.updateAutoForwarding` | 5 |\n| `settings.updateImap` | 5 |\n| `settings.updatePop` | 100 |\n| `settings.updateVacation` | 5 |\n| `stop` | 50 |\n| `threads.delete` | 20 |\n| `threads.get` | 10 |\n| `threads.list` | 10 |\n| `threads.modify` | 10 |\n| `threads.trash` | 10 |\n| `threads.untrash` | 10 |\n| `watch` | 100 |"]]
