Batas dan kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Enterprise License Manager API dengan cara yang tidak tepat. Permintaan yang berlebihan dari API dapat disebabkan oleh kesalahan ketik yang tidak berbahaya, atau mungkin disebabkan oleh sistem yang tidak dirancang secara efisien yang membuat panggilan API yang tidak perlu. Apa pun penyebabnya, pemblokiran traffic dari sumber tertentu setelah mencapai tingkat tertentu diperlukan untuk kesehatan sistem Google Workspace secara keseluruhan. Mode Izin memastikan bahwa tindakan developer tertentu tidak dapat berdampak negatif pada komunitas yang lebih luas.
Jika permintaan API gagal, Anda akan menerima respons kode status HTTP. Kode status 403 memiliki 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 mendeteksi error ini dan mengambil tindakan yang tepat.
Jika permintaan Anda harus diselesaikan dalam jangka waktu tertentu, kirim permintaan Anda dalam batch. Bergantung pada tujuan API Anda dan jika jumlah permintaan terlalu tinggi, error kuota akan terjadi.
Jika Anda tidak dapat menggunakan fitur permintaan batch API yang direkomendasikan, gunakan algoritma backoff eksponensial. Untuk semua error yang berbasis waktu (maksimum N sesuatu selama X detik per thread), terutama error kode status 503, sebaiknya kode Anda menangkap pengecualian dan, menggunakan algoritma backoff eksponensial, tunggu sedikit penundaan sebelum mencoba kembali panggilan yang gagal. Contoh Enterprise License Manager 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 menskalakan kembali frekuensi permintaan hingga panggilan berhasil. Misalnya, tingkatkan penundaan 5 detik awal 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 penundaan yang berbeda sebelum aplikasi Anda menampilkan error kepada pengguna.
| Kategori Kuota API | Kuota |
|---|---|
| Kueri per detik (QPS) | Kuota QPS adalah 1. |
| Kategori Batas API | Batas |
|---|---|
| String kueri maxResults | Ukuran maksimum maxResults adalah 100. |
| Jenis Batas Lainnya | Batasan dan Pedoman |
|---|---|
| Permintaan batch |
API mendukung pengiriman permintaan batch. |
| Format data dalam respons API | Format data respons adalah JavaScript Object Notation (JSON). |
| Mengaktifkan Enterprise License Manager API | Provisioning API harus diaktifkan sebelum melakukan panggilan ke Enterprise License Manager API. Di panel kontrol Anda, buka halaman Setelan pada tab Pengguna dan grup, lalu aktifkan Provisioning API. Simpan perubahan Anda. Selain itu, layanan Google Grup harus diaktifkan dan diaktifkan. |
| Permintaan tidak sah | API tidak menerima permintaan tidak sah. Permintaan dianggap tidak sah jika tidak ada token otorisasi yang diberikan. Untuk informasi selengkapnya, lihat Mengizinkan Permintaan. |