Batas dan kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Alert Center 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 mana yang telah terlampaui. Respons ini memungkinkan aplikasi kustom mendeteksi error ini dan mengambil tindakan yang tepat.
Jika permintaan Anda perlu diselesaikan dalam jangka waktu yang tetap, kirim permintaan Anda secara paralel atau gunakan beberapa thread di aplikasi Java atau C# Anda. Contoh permintaan paralel adalah meminta batch kecil email dari pengguna yang berbeda, bukan menambahkan atau menghapus banyak email dari satu pengguna secara bersamaan. Untuk rangkaian pesan, cobalah memulai dengan 10 rangkaian pesan, satu rangkaian pesan per email pengguna. Perlu diperhatikan, rekomendasi thread memiliki konsekuensi dan tidak berguna untuk semua situasi API. Jika jumlah permintaan terlalu tinggi, error kuota akan terjadi.
Untuk semua error yang berbasis waktu (maksimum N objek selama N 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 Alert Center 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 Batas API | Batas |
|---|---|
| Tarif QPS dan QPD Pusat Notifikasi | API membatasi jumlah permintaan untuk project Konsol API Anda. Jumlah maksimum permintaan per detik (project QPS) project API adalah 1.000. Selain itu, jumlah maksimum permintaan per pengguna per detik (QPS pengguna) adalah 150.
Jika batas ini terlampaui, server akan menampilkan kode status HTTP |
| Jenis Batas Lainnya | Batasan dan Pedoman |
|---|---|
| Format data, default | Format data default adalah JSON. |
| Permintaan tidak sah | Google tidak mengizinkan permintaan tidak sah ke API ini. Permintaan dianggap tidak sah jika tidak ada token otorisasi yang diberikan. Untuk informasi selengkapnya, lihat Mengizinkan permintaan. |
Meminta penambahan kuota per project
Bergantung pada penggunaan resource project, Anda mungkin ingin meminta penambahan kuota. Panggilan API oleh akun layanan dianggap menggunakan satu akun. Mengajukan permohonan penambahan kuota tidak menjamin persetujuan. Penambahan kuota yang besar memerlukan waktu lebih lama untuk disetujui.
Tidak semua project memiliki kuota yang sama. Seiring peningkatan penggunaan Google Cloud dari waktu ke waktu, kuota Anda mungkin perlu ditingkatkan. Jika Anda memperkirakan akan ada peningkatan penggunaan yang signifikan, Anda dapat secara proaktif meminta penyesuaian kuota dari halaman Quotas di Google Cloud Console.
Untuk mempelajari lebih lanjut, lihat referensi berikut:
- Tentang permintaan penambahan kuota
- Melihat penggunaan dan batas kuota Anda saat ini
- Meminta batas kuota yang lebih tinggi