Batas dan kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Reseller API secara tidak tepat. Permintaan yang berlebihan dapat disebabkan oleh salah ketik atau desain sistem yang tidak efisien. Untuk membantu memastikan kesehatan sistem Google Workspace, Google memblokir traffic dari sumber tertentu saat mencapai tingkat tertentu. Hal ini memastikan bahwa tindakan satu developer tidak berdampak negatif pada komunitas.
Kegagalan permintaan API
Jika permintaan API gagal, aplikasi Anda akan menerima kode status HTTP. Kode status
403 menunjukkan input yang salah, dan kode status 503
menunjukkan bahwa kuota API telah terlampaui. Gunakan respons ini untuk mendeteksi
kesalahan dan mengambil tindakan.
Error berbasis waktu
Untuk error berbasis waktu, terutama kode status 503, gunakan algoritma
backoff eksponensial. Tunggu penundaan singkat sebelum mencoba lagi panggilan yang gagal. Misalnya, tunggu 5 detik dan coba lagi. Jika berhasil, ulangi pola untuk
thread lainnya. Jika permintaan kedua gagal, kurangi frekuensi permintaan hingga panggilan berhasil. Sebaiknya tentukan batas percobaan ulang, seperti 5 hingga 7
kali.
Batas
| Kategori batas API | Batas |
|---|---|
Langganan purchaseOrderId |
Properti ini menerima hingga 80 karakter teks biasa. |
Langganan maxResults |
String kueri maxResults dapat berupa 1–100 hasil.
Defaultnya adalah 20 hasil.
|
Token transfer (customerAuthToken) |
Masa berlaku token transfer pelanggan adalah 30 hari setelah dibuat. |
| Jumlah pengguna maksimum untuk pelanggan | Bergantung pada kontrak Anda, jumlah maksimum pengguna dapat mencapai 50.000 atau jumlah maksimum yang ditentukan dalam kontrak reseller Anda. |
| Permintaan tidak sah | Google tidak mengizinkan permintaan yang tidak sah ke Reseller API. Permintaan tidak sah jika tidak ada token otorisasi yang diberikan. Untuk mengetahui informasi selengkapnya, lihat Mempelajari autentikasi & otorisasi. |
Jenis batas lainnya
| Jenis batas lainnya | Batasan dan panduan |
|---|---|
| Format data |
Format data adalah JavaScript Object Notation
(JSON).
JSON adalah format internet umum untuk menampilkan struktur data arbitrer. Format ini adalah format teks independen bahasa yang menggunakan konvensi yang familier bagi programmer bahasa keluarga C, termasuk C, C++, C#, Java, JavaScript, Perl, dan Python. |
| Format waktu | Tanggal dan waktu menggunakan Konverter epoch dalam milidetik. Format ini berlaku untuk waktu pembuatan langganan, waktu mulai dan berakhir komitmen paket, serta waktu berakhir uji coba gratis. |