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 kesalahan ketik, atau mungkin akibat sistem yang tidak efisien yang membuat panggilan API yang tidak perlu. Apa pun penyebabnya, pemblokiran traffic dari sumber tertentu saat mencapai tingkat tertentu diperlukan untuk kesehatan sistem Google Workspace secara keseluruhan. Batasan membantu memastikan bahwa tindakan satu developer tidak dapat berdampak negatif terhadap komunitas yang lebih besar.
Jika permintaan API Anda gagal, Anda akan menerima respons kode status HTTP. Kode status 403 berisi informasi error tentang input yang salah, dan
kode status HTTP 503 berisi informasi error yang menunjukkan kuota API
yang telah terlampaui. Respons ini memungkinkan aplikasi kustom Anda mendeteksi error ini dan mengambil
tindakan yang tepat.
Jika permintaan Anda perlu diselesaikan dalam jangka waktu tetap, kirim permintaan Anda secara paralel atau gunakan beberapa thread di aplikasi Java atau C# Anda. Contoh permintaan paralel adalah meminta sekelompok kecil email dari pengguna yang berbeda daripada menambahkan atau menghapus banyak email dari satu pengguna secara bersamaan. Untuk thread, coba mulai dengan 10 thread, satu thread per email pengguna. Perhatikan, rekomendasi thread memiliki konsekuensi dan tidak berguna untuk semua situasi API. Jika jumlah permintaan terlalu tinggi, error kuota akan terjadi. Contoh kompromi lainnya adalah kuota Email Audit API untuk tingkat upload pesan maksimum secara keseluruhan. Laju upload adalah satu permintaan API - per detik - per pengguna, berapa pun jumlah thread yang membuat permintaan upload.
Untuk semua error yang berbasis waktu (maksimum N hal untuk N detik per thread), khususnya
error kode status 503, sebaiknya kode Anda menemukan pengecualian tersebut, dan, dengan menggunakan algoritme backoff eksponensial, tunggu sedikit keterlambatan sebelum mencoba kembali panggilan yang gagal. Contoh Email Audit API untuk satu thread adalah menunggu selama 5 detik dan mencoba lagi panggilan yang gagal. Jika permintaan tersebut
berhasil, ulangi pola ini untuk thread lainnya. Jika permintaan kedua tidak berhasil,
aplikasi Anda harus melakukan penskalaan pada frekuensi permintaan hingga panggilan berhasil.
Misalnya, tingkatkan penundaan 5 detik awal menjadi 10 detik dan coba lagi panggilan yang gagal
lagi. Selain itu, tentukan batas percobaan ulang. Misalnya, coba lagi permintaan 5 hingga 7 kali dengan waktu keterlambatan 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 beberapa hari untuk disiapkan oleh sistem, bergantung pada ukurannya. |
| File kotak surat terenkripsi, error dengan penghapusan | Saat Menghapus kotak surat yang dienkripsi dan terjadi error, permintaan akan diberi status MARKED_DELETE. File ringkasan dan ekspor ini akan otomatis dihapus oleh Google lagi dalam waktu 24 jam (dengan kemungkinan file yang tersisa). Jika status MARKED_DELETE ditampilkan
secara konsisten, 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 | Konversikan semua tanggal ke format Coordinated Universal Time (UTC) sebelum menggunakannya dengan Email Audit API. Untuk informasi selengkapnya, lihat pengonversi UTC. |
File kotak surat terenkripsi, EXPIRED ringkasan, dan ekspor file
|
Google menyimpan file kotak surat yang dienkripsi 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 yang dienkripsi menggunakan format mbox. |
| File kotak surat terenkripsi, permintaan pembuatan maksimum | Permintaan pembuatan ekspor kotak surat maksimum 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
maksimum 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 pemantau email per hari adalah 1500. Batas ini ditujukan untuk domain dan mencakup semua permintaan yang dibuat oleh administrator selama hari tersebut. |
| Kunci publik | Email Audit API hanya mendukung satu kunci.
Kunci publik menggunakan software GNU Privacy Guard (GPG). Ini dalam format PGP dan merupakan kunci enkripsi RSA berenkode ASCII. Sebelum mengupload kunci publik, Anda harus terlebih dahulu mengonversinya menjadi string berenkode base64. File kunci publik harus membaca dengan charset US-ASCII, (IANA nama charset pilihan untuk ASCII). |
| Menelusuri | Parameter searchQuery dan includeDeleted tidak dapat terjadi bersamaan. Kueri penelusuran tidak mungkin dilakukan jika includeDeleted="true".
|