Batas penggunaan dan kuota

Batas dan kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Email Audit API dengan cara yang tidak tepat. Permintaan yang berlebihan dari API mungkin disebabkan oleh salah ketik yang tidak berbahaya, atau mungkin disebabkan oleh sistem yang dirancang secara tidak efisien sehingga melakukan panggilan API yang tidak perlu. Terlepas dari penyebabnya, memblokir traffic dari sumber tertentu saat mencapai tingkat tertentu diperlukan untuk kesehatan keseluruhan sistem Google Workspace. Batas membantu memastikan bahwa tindakan satu developer tidak dapat berdampak negatif pada komunitas yang lebih besar.

Jika permintaan API Anda gagal, Anda akan menerima respons kode status HTTP. Kode status 403 memiliki informasi error tentang input yang salah, dan kode status HTTP 503 memiliki informasi error yang menunjukkan kuota API mana yang telah terlampaui. Respons ini memungkinkan aplikasi kustom Anda mendeteksi error ini dan mengambil tindakan yang sesuai.

Jika permintaan Anda harus diselesaikan dalam jangka waktu yang tetap, kirimkan permintaan Anda secara paralel atau gunakan beberapa thread di aplikasi Java atau C# Anda. Contoh permintaan paralel adalah meminta batch kecil email dari pengguna yang berbeda, bukan menambahkan atau menghapus banyak email dari satu pengguna secara bersamaan. Dalam kasus thread, coba mulai dengan 10 thread, satu thread per email pengguna. Perhatikan bahwa rekomendasi thread memiliki kekurangan dan tidak berguna untuk semua situasi API. Jika jumlah permintaan terlalu tinggi, error kuota akan terjadi. Contoh trade-off lainnya adalah kuota untuk Email Audit API untuk kecepatan upload pesan keseluruhan maksimum. Kecepatan upload adalah satu permintaan API per detik per pengguna, berapa pun jumlah thread yang membuat permintaan upload.

Untuk semua error berbasis waktu (maksimum N item untuk N detik per thread), terutama error kode status 503, sebaiknya kode Anda menangkap pengecualian dan, dengan menggunakan algoritma backoff eksponensial, tunggu penundaan singkat sebelum mencoba ulang panggilan yang gagal. Contoh Email Audit API untuk satu rangkaian pesan adalah menunggu 5 detik dan mencoba ulang panggilan yang gagal. Jika permintaan berhasil, ulangi pola ini untuk thread lainnya. Jika permintaan kedua tidak berhasil, aplikasi Anda harus mengurangi frekuensi permintaan hingga panggilan berhasil. Misalnya, tingkatkan penundaan awal 5 detik menjadi 10 detik dan coba lagi panggilan yang gagal. Selain itu, tentukan batas percobaan ulang. Misalnya, coba lagi permintaan 5 hingga 7 kali dengan waktu tunda yang berbeda sebelum aplikasi Anda menampilkan error kepada pengguna.

Tabel berikut mencantumkan batas untuk Email Audit API:

Kategori batas API	Batas
File kotak surat terenkripsi, pembuatan	Pembuatan file kotak surat terenkripsi mungkin memerlukan waktu hingga beberapa hari agar sistem siap, bergantung pada ukurannya.
File kotak surat terenkripsi, error saat penghapusan	Jika Menghapus kotak surat terenkripsi dan terjadi error, permintaan akan diberi status MARKED_DELETE. Ringkasan dan file ekspor ini akan otomatis dihapus lagi oleh Google dalam waktu 24 jam (dengan kemungkinan file yang tersisa). Jika status MARKED_DELETE terus ditampilkan, coba strategi backoff eksponensial.

Tabel berikut mencantumkan kuota untuk Email Audit API:

Kategori kuota API	Kuota
Token autentikasi ClientLogin	Berlaku selama 24 jam. Errornya adalah 401 token expired.
Format tanggal	Konversi semua tanggal ke format Coordinated Universal Time (UTC) sebelum menggunakannya dengan Email Audit API. Untuk mengetahui informasi selengkapnya, lihat pengonversi UTC.
File kotak surat terenkripsi, ringkasan EXPIRED, dan file yang diekspor	Google menyimpan file kotak surat terenkripsi selama 3 minggu. Setelah itu, pesan akan dihapus. Administrator domain bertanggung jawab untuk mendownload file kotak surat ini dalam jangka waktu ini.
File kotak surat terenkripsi, format	File kotak surat terenkripsi dalam format mbox.
File kotak surat terenkripsi, permintaan pembuatan maksimum	Jumlah maksimum permintaan pembuatan ekspor kotak surat per hari adalah total 100 permintaan dari semua administrator di domain.
Status file kotak surat terenkripsi, penomoran halaman	Saat meminta status semua permintaan kotak surat, respons dapat menampilkan data dalam jumlah besar. Email Audit API mengelompokkan data ini ke dalam halaman dengan setiap halaman berisi maksimal 100 entri, dan URI dalam tag link rel='next'yang mengarah ke halaman hasil berikutnya. Saat mengembangkan aplikasi klien, kode Anda perlu mengelola hasil tambahan ini.
Pemantau email	Jumlah maksimum permintaan pemantauan email per hari adalah 1.500. Batas ini berlaku untuk domain dan mencakup semua permintaan yang dibuat oleh administrator mana pun selama hari tersebut.
Kunci publik	Email Audit API hanya mendukung satu kunci. Kunci publik menggunakan software GNU Privacy Guard (GPG). Kunci ini dalam format PGP dan merupakan kunci enkripsi RSA yang dienkode ASCII. Sebelum mengupload kunci publik, Anda harus mengonversinya terlebih dahulu menjadi string berenkode base64. File kunci publik harus dibaca dengan charset US-ASCII, (IANA nama charset pilihan untuk ASCII).
Menelusuri	Parameter searchQuery dan includeDeleted tidak dapat digunakan bersamaan. Kueri penelusuran tidak dapat dilakukan jika includeDeleted="true".