Batas penggunaan API

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.