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 dirancang secara tidak efisien yang melakukan panggilan API yang tidak perlu. Apa pun penyebabnya, memblokir lalu lintas dari sumber tertentu setelah mencapai tingkat tertentu yang diperlukan untuk kesehatan sistem Google Workspace secara keseluruhan.
Kegagalan permintaan API
Jika permintaan API Anda gagal, aplikasi Anda akan menerima kode status HTTP
yang dihasilkan. Kode status HTTP 403 memiliki informasi error yang menunjukkan kuota API
telah terlampaui. Respons tersebut memungkinkan aplikasi kustom Anda mendeteksi error dan
tindakan.
Permintaan mendesak
Jika permintaan Anda harus diselesaikan dalam jangka waktu yang tetap, kirimkan permintaan Anda secara paralel atau menggunakan beberapa thread di aplikasi Java atau C#. Misalnya, pisahkan permintaan Anda berdasarkan bulan atau periode waktu lain. Untuk thread, coba mulai dengan 10 thread, satu thread per permintaan. Rekomendasi thread memiliki konsekuensi dan tidak berguna untuk semua situasi API. Jika jumlah terlalu tinggi, terjadi error kuota.
Error berbasis waktu
Untuk semua error yang berbasis waktu (maksimum N hal selama X detik per thread), terutama
503 error kode status, sebaiknya kode Anda menangkap pengecualian, dan dengan menggunakan
sebuah
backoff eksponensial
server, tunggu sedikit penundaan sebelum mencoba kembali panggilan yang gagal. Contoh Groups Settings API untuk
satu thread adalah menunggu 5 detik dan
mencoba lagi panggilan yang gagal. Jika permintaan berhasil, ulangi proses ini
untuk thread lainnya. Jika permintaan kedua tidak berhasil, permohonan Anda harus
menurunkan frekuensi permintaan
hingga panggilan berhasil. Misalnya, tingkatkan
penundaan awal 5 detik hingga 10 detik dan coba lagi panggilan yang gagal. Selain itu, tentukan percobaan ulang
batas tersebut. Misalnya, coba lagi permintaan 5 hingga 7 kali dengan waktu tunda berbeda sebelum aplikasi Anda
mengembalikan {i>error<i} kepada pengguna.
Kuota
| Kategori kuota API | Kuota |
|---|---|
| Kueri per hari | Anda dapat membuat hingga 100.000 kueri per hari. Jika Anda membutuhkan kapasitas lebih dari batas ini, Anda dapat mengirim permintaan dari Halaman Quotas di Konsol Google Cloud |
| Deskripsi grup, ukuran maksimum | Anda dapat memasukkan deskripsi grup hingga 4.096 karakter. |
| Nama grup, ukuran maksimum | Nama grup dapat berisi hingga 60 karakter. |
defaultMessageDenyNotificationText |
Teks notifikasi dapat berisi hingga 10.000 karakter. Untuk mempelajari selengkapnya tentang
defaultMessageDenyNotificationText, lihat
Referensi API.
|
maxMessageBytes |
Ukuran pesan maksimum default adalah 1 MB. Untuk mempelajari maxMessageBytes lebih lanjut
lihat referensi API.
|
Batas
| Jenis batas | Batasan dan panduan |
|---|---|
| Format data, default |
Format data default adalah JSON. API ini juga mendukung format Atom. JSON dan Atom format data yang sama mendukung kemampuan baca-tulis penuh. Untuk informasi selengkapnya, lihat Format data JSON dan Atom. |
| Groups Settings API, pengaktifan | Anda harus mengaktifkan Directory API sebelum melakukan panggilan ke Groups Settings API informasi selengkapnya, lihat Mengaktifkan Google Workspace API. |