Batas dan kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Groups Settings API dengan cara yang tidak tepat. Permintaan yang berlebihan dari API dapat disebabkan oleh kesalahan ketik yang tidak berbahaya atau sistem yang tidak dirancang secara efisien yang melakukan panggilan API yang tidak perlu. Apa pun penyebabnya, memblokir traffic dari sumber tertentu setelah mencapai tingkat tertentu diperlukan untuk kesehatan keseluruhan sistem Google Workspace.
Kegagalan permintaan API
Jika permintaan API Anda gagal, aplikasi Anda akan menerima respons kode status HTTP. Kode status HTTP 403
berisi informasi error yang menunjukkan kuota API mana yang telah terlampaui. Responsnya memungkinkan aplikasi kustom Anda mendeteksi error dan mengambil tindakan
yang tepat.
Permintaan sensitif waktu
Jika permintaan Anda perlu diselesaikan dalam jangka waktu tertentu, kirim permintaan secara paralel atau gunakan beberapa thread di aplikasi Java atau C#. Misalnya, potong permintaan Anda berdasarkan bulan atau jangka waktu lainnya. Untuk thread, coba mulai dengan 10 thread, satu thread per permintaan. Rekomendasi thread memiliki konsekuensi dan hanya berguna untuk semua situasi API. Jika jumlah permintaan terlalu tinggi, error kuota akan terjadi.
Error berbasis waktu
Untuk semua error yang berbasis waktu (maksimum N hal selama X detik per thread), terutama
error kode status 503
, sebaiknya kode Anda menangkap pengecualian tersebut, dan dengan menggunakan
algoritma
backoff eksponensial, tunggu sedikit penundaan sebelum mencoba lagi panggilan yang gagal. Contoh Groups Settings API untuk
satu thread adalah menunggu 5 detik dan mencoba lagi 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 5 detik awal menjadi 10 detik, lalu 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
menampilkan error kepada pengguna.
Kuota
Kategori kuota API | Kuota |
---|---|
Kueri per hari | Anda dapat membuat hingga 100.000 kueri per hari. Jika memerlukan kapasitas di luar batas ini, Anda dapat mengirimkan permintaan dari halaman Kuota di Google Cloud Console |
Deskripsi grup, ukuran maksimum | Anda dapat memasukkan deskripsi grup hingga 300 karakter. |
Nama grup, ukuran maksimum | Nama grup dapat memiliki maksimal 60 karakter. |
defaultMessageDenyNotificationText |
Teks notifikasi dapat berisi hingga 10.000 karakter. Untuk mempelajari properti defaultMessageDenyNotificationText lebih lanjut, baca referensi API.
|
maxMessageBytes |
Ukuran pesan maksimum default adalah 1 MB. Untuk mempelajari properti maxMessageBytes lebih lanjut, baca referensi API.
|
Batas
Jenis batas | Batasan dan panduan |
---|---|
Format data, default |
Format data default adalah JSON. API juga mendukung format Atom. Format data JSON dan Atom mendukung kemampuan baca-tulis penuh. Untuk mengetahui informasi selengkapnya, lihat format data JSON dan Atom. |
Groups Settings API, pengaktifan | Anda harus mengaktifkan Directory API sebelum melakukan panggilan ke Groups Settings API. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan Google Workspace API. |