Kuota penggunaan Mail Admin Quarantine API

Mail Admin Quarantine API menerapkan kuota penggunaan per menit untuk setiap project Google Cloud guna melindungi infrastruktur Google Workspace yang menelusuri dan mengambil pesan yang dikarantina. Kuota dikelompokkan berdasarkan jenis pekerjaan yang dilakukan metode.

Kuota

Tabel berikut mencantumkan kuota. Setiap kuota adalah per menit per project Cloud, dan menghitung semua permintaan yang dibuat project di semua pelanggan Google Workspace dan administrator yang ditiru identitasnya.

Kuota Nilai Metode
Permintaan penelusuran dan daftar 60 permintaan per menit customers.quarantinedMessages.list, customers.quarantinedMessages.search
Permintaan baca 1.200 permintaan per menit customers.quarantinedMessages.get, customers.quarantines.get, customers.quarantines.list, customers.operations.get
Permintaan tulis 300 permintaan per menit customers.quarantinedMessages.release, customers.quarantinedMessages.deny, customers.quarantinedMessages.batchRelease, customers.quarantinedMessages.batchDeny

Setiap panggilan API dihitung sebagai satu permintaan, terlepas dari ukuran halaman atau, untuk metode batch, jumlah pesan dalam batch. Misalnya, permintaan batchRelease dengan 500 pesan menggunakan satu permintaan tulis.

Anda dapat melihat penggunaan kuota project saat ini di konsol Google Cloud di bagian APIs & Services > Enabled APIs & services > Admin Quarantine API > Quotas & System Limits.

Batasan permintaan

Batasan Nilai
pageSize maksimum untuk permintaan list dan search 300 pesan
Pesan maksimum per permintaan batchRelease atau batchDeny 500 pesan
Jendela penelusuran dan daftar Pesan yang diterima dalam 30 hari terakhir

Mengatasi error kuota

Jika project Anda melebihi kuota, API akan menampilkan error HTTP 429 dengan status RESOURCE_EXHAUSTED:

{
  "error": {
    "code": 429,
    "message": "Quota exceeded for quota metric 'Search and list quarantined messages requests' and limit 'Search and list requests per minute per project' of service 'mailadminquarantine.googleapis.com' for consumer 'project_number:123456789012'.",
    "status": "RESOURCE_EXHAUSTED"
  }
}

Agar tetap berada dalam kuota:

  • Coba lagi dengan backoff eksponensial. Saat Anda menerima error 429, tunggu sebelum mencoba lagi dan tingkatkan waktu tunggu setelah setiap upaya yang gagal. Untuk mengetahui detailnya, lihat Backoff eksponensial.
  • Gunakan ukuran halaman terbesar yang berguna. Permintaan penelusuran dan daftar memiliki kuota terkecil. Minta hingga 300 pesan per halaman, bukan banyak halaman kecil.
  • Gunakan filter. Persempit permintaan search dengan filter atau query agar Anda hanya mengambil pesan yang diperlukan.
  • Gunakan metode batch untuk tindakan massal. Satu permintaan batchRelease atau batchDeny dapat merilis atau menolak hingga 500 pesan, dibandingkan dengan satu pesan per panggilan release atau deny.
  • Lakukan polling operasi seperlunya. Saat Anda menunggu operasi batch, panggil metode get dari resource customers.operations setiap beberapa detik, bukan terus-menerus.
  • Sinkronkan secara inkremental. Daripada mencantumkan ulang seluruh karantina pada setiap eksekusi, filter status = PENDING_TRIAGE dan proses hanya pesan baru.

Peningkatan kuota tidak tersedia selama Pratinjau Developer. Jika kasus penggunaan Anda memerlukan kuota yang lebih tinggi, sampaikan masukan Anda melalui Program Pratinjau Developer Google Workspace.