Batas dan kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Admin Settings API dengan cara yang tidak tepat. Permintaan yang berlebihan dari API dapat disebabkan oleh kesalahan ketik yang tidak berbahaya, atau dapat disebabkan oleh sistem yang dirancang secara tidak efisien yang melakukan panggilan API yang tidak perlu. Terlepas dari penyebabnya, memblokir traffic dari sumber tertentu setelah mencapai tingkat tertentu diperlukan untuk kesehatan keseluruhan sistem Google Workspace. Hal ini memastikan bahwa tindakan satu developer tidak dapat berdampak negatif pada komunitas yang lebih besar.
Jika permintaan API Anda gagal, Anda akan menerima respons kode status HTTP. Kode status 403 memiliki informasi error tentang input yang salah, dan kode status HTTP 503 memiliki informasi error yang menunjukkan kuota API mana yang telah terlampaui. Respons ini memungkinkan aplikasi kustom Anda mendeteksi error ini dan mengambil tindakan yang sesuai.
Jika permintaan Anda harus diselesaikan dalam jangka waktu yang tetap, kirimkan permintaan Anda secara paralel atau gunakan beberapa thread di aplikasi Java atau C# Anda. Misalnya, bagi permintaan Anda berdasarkan bulan atau jangka waktu lainnya. Dalam kasus thread, coba mulai dengan 10 thread, satu thread per permintaan. Perhatikan bahwa rekomendasi thread memiliki kelebihan dan kekurangan serta tidak berguna untuk semua situasi API. Jika jumlah permintaan terlalu tinggi, error kuota akan terjadi.
Untuk semua error berbasis waktu (maksimum N item selama X detik per thread), terutama error kode status 503, sebaiknya kode Anda menangkap pengecualian dan, menggunakan algoritma penundaan eksponensial, tunggu penundaan singkat sebelum mencoba kembali panggilan yang gagal. Contoh Email Settings API untuk satu rangkaian pesan 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 awal 5 detik 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 tunda yang berbeda sebelum aplikasi Anda menampilkan error kepada pengguna.
| Kategori Kuota API | Kuota |
|---|---|
| Token autentikasi ClientLogin | Berlaku selama 24 jam. Errornya adalah '401 token expired'. |
| Membuat kunci publik dan pribadi |
Dengan penyedia identitas Anda, buat serangkaian kunci publik dan pribadi menggunakan algoritma DSA atau RSA. Kunci publik ada dalam sertifikat berformat X.509. Untuk mengetahui informasi selengkapnya tentang kunci penandatanganan Single Sign-On berbasis SAML, lihat Membuat Kunci dan Sertifikat untuk Layanan Single Sign-On Google Workspace. |
| Logo |
File gambar logo akun dapat berformat JPEG, PNG, atau GIF. Ukuran yang direkomendasikan adalah 143 x 59 piksel dan ukuran file harus lebih kecil dari 20 KB. Saat menggunakan logo kustom, ingatlah untuk mematuhi Persyaratan Layanan Google. Selain itu, jangan menggunakan logo Google, logo Gmail, atau logo Google lainnya. Untuk mengetahui informasi selengkapnya, lihat Kebijakan logo dan halaman landing. |
| ssoWhitelist |
ssoWhitelist adalah alamat IP network mask dalam format Classless Inter-Domain Routing (CIDR). |
| Jenis Batas Lainnya | Batasan dan Pedoman |
|---|---|
| Status verifikasi data MX |
Status verifikasi data MX default adalah `false` yang berarti sistem Google belum memeriksa konfigurasi data MX Anda baru-baru ini atau data MX Anda belum dikonfigurasi agar mengarah ke sistem Google. Jika Anda telah memperbarui data dan status verifikasi tetap salah, hal ini dapat berarti pembaruan data MX Anda belum diterapkan, atau ada kesalahan ketik dalam data. Untuk propagasi, sebaiknya Anda menunggu selama durasi waktu yang ditentukan oleh nilai Time To Live (TTL) data MX dan mencoba lagi. |
| Kode negara |
Jika nama organisasi belum disesuaikan, nama defaultnya adalah nama domain utama Anda. Untuk mengetahui informasi tentang karakter nama organisasi, lihat Penggunaan karakter. |
properti creationTime, representasi numerik tanggal dan waktu |
Lihat ISO 8601, Representasi Numerik Tanggal dan Waktu. |
| Tag encoding bahasa |
Lihat tag bahasa RFC 3066yang diterima oleh Google Mail. |
| Nama organisasi |
Jika nama organisasi belum disesuaikan, nama defaultnya adalah nama domain utama Anda. Untuk mengetahui informasi tentang karakter nama organisasi, lihat Penggunaan karakter. |
Meminta penambahan kuota per project
Bergantung pada penggunaan resource project, Anda mungkin ingin meminta penyesuaian kuota. Panggilan API oleh akun layanan dianggap menggunakan satu akun. Mengajukan permohonan untuk penyesuaian kuota belum tentu disetujui. Permintaan penyesuaian kuota yang akan meningkatkan nilai kuota secara signifikan membutuhkan waktu lebih lama untuk disetujui.
Tidak semua project memiliki kuota yang sama. Seiring meningkatnya penggunaan Google Cloud dari waktu ke waktu, nilai kuota Anda mungkin perlu ditingkatkan. Jika Anda memperkirakan adanya peningkatan penggunaan yang signifikan di masa mendatang, Anda dapat secara proaktif meminta penyesuaian kuota dari halaman Kuota di konsol Google Cloud.
Untuk mempelajari lebih lanjut, lihat referensi berikut:
- Tentang penyesuaian kuota
- Melihat penggunaan dan batas kuota saat ini
- Meminta batas kuota yang lebih tinggi