Batas dan kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Admin Settings API dengan cara yang tidak pantas. Permintaan yang berlebihan dari API mungkin disebabkan oleh kesalahan ketik, atau mungkin akibat sistem yang tidak efisien yang membuat panggilan API yang tidak perlu. Apa pun penyebabnya, memblokir traffic dari sumber tertentu setelah mencapai tingkat tertentu diperlukan untuk kesehatan sistem Google Workspace secara keseluruhan. 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 ketika permintaan API gagal. Kode status 403 memiliki informasi error tentang input yang salah, dan kode status HTTP 503 memiliki informasi error yang menunjukkan kuota API yang telah terlampaui. Respons ini memungkinkan aplikasi kustom Anda mendeteksi error ini dan mengambil tindakan yang sesuai.
Jika permintaan Anda perlu diselesaikan dalam jangka waktu tetap, kirim permintaan Anda secara paralel atau gunakan beberapa thread di aplikasi Java atau C# Anda. Misalnya, uraikan permintaan Anda berdasarkan bulan atau jangka waktu lainnya. Untuk thread, coba mulai dengan 10 thread, satu thread per permintaan. Perhatikan, 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 hal selama X detik per thread), terutama error kode status 503, sebaiknya kode Anda menemukan pengecualian dan, menggunakan algoritme backoff eksponensial, tunggu sedikit keterlambatan sebelum mencoba kembali panggilan yang gagal. Contoh Email Settings API untuk satu thread adalah menunggu 5 detik dan mencoba lagi panggilan yang gagal. Jika permintaan tersebut berhasil, ulangi pola ini untuk thread lainnya. Jika permintaan kedua tidak berhasil, aplikasi Anda harus menurunkan skala pada frekuensi permintaan tersebut 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 |
|---|---|
| Token autentikasi ClientLogin | Berlaku selama 24 jam. Errornya adalah masa berlaku token '401'. |
| Membuat kunci publik dan pribadi | Dengan penyedia identitas Anda, buat satu set kunci publik dan pribadi menggunakan algoritme DSA atau RSA. Kunci publik menggunakan sertifikat berformat X.509. Untuk 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 dalam format JPEG, PNG, atau GIF. Ukuran yang direkomendasikan adalah 143 x 59 piksel dan file harus lebih kecil dari 20 Kb. Saat menggunakan logo khusus, jangan lupa untuk tetap berada dalam Persyaratan Layanan Google. Selain itu, jangan gunakan logo Google, logo Gmail, atau logo Google lainnya. Untuk informasi selengkapnya, lihat Kebijakan logo dan halaman landing. |
| ssoDaftar putih | ssoAllowed adalah alamat IP mask jaringan dengan format Pemilihan Rute Inter-Domain Tanpa Class (CIDR). |
| Jenis Batas Lainnya | Batasan dan Panduan |
|---|---|
| Status verifikasi data MX | Status verifikasi data MX default adalah `false` yang berarti bahwa sistem Google belum memeriksa konfigurasi data MX Anda atau data MX Anda belum dikonfigurasi untuk mengarah ke sistem Google. Jika Anda telah memperbarui data dan status verifikasi tetap salah, itu berarti pembaruan data MX Anda belum diterapkan, atau ada salah ketik pada data. Untuk penerapan, sebaiknya tunggu jumlah waktu yang ditentukan oleh nilai Time To Live (TTL) data MX, lalu coba lagi. |
| Kode negara | Jika nama organisasi belum disesuaikan, defaultnya adalah nama domain primer Anda. Untuk 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 3066 yang diterima oleh Google Mail. |
| Nama organisasi | Jika nama organisasi belum disesuaikan, defaultnya adalah nama domain primer Anda. Untuk informasi tentang karakter nama organisasi, lihat Penggunaan karakter. |