Batas dan kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Reseller API dengan cara yang tidak tepat. Permintaan 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, memblokir traffic dari sumber tertentu saat mencapai tingkat tertentu diperlukan untuk kesehatan sistem Google Workspace secara keseluruhan. Solusi ini memastikan bahwa tindakan developer tidak dapat berdampak negatif pada komunitas yang lebih besar.
Kegagalan permintaan API
Jika permintaan API gagal, aplikasi 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 tepat.
Error berbasis waktu
Untuk semua error yang berbasis waktu (maksimum N sesuatu selama N detik per
thread), terutama error kode status 503, sebaiknya
kode Anda menangkap pengecualian dan dengan
menggunakan algoritma
backoff eksponensial, tunggu beberapa saat sebelum mencoba kembali panggilan yang gagal. Contoh
Reseller 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 menampilkan error kepada pengguna.
Batas
| Kategori batas API | Batas |
|---|---|
Langganan purchaseOrderId |
Properti ini menerima hingga 80 karakter teks biasa. |
Langganan maxResults |
String kueri maxResults dapat berisi 1 - 100 hasil.
Defaultnya adalah 20 hasil.
|
Token Transfer (customerAuthToken) |
Token transfer pelanggan valid selama 30 hari setelah dibuat. |
| Jumlah maksimum pengguna untuk satu 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 tidak sah ke Reseller API. Permintaan dianggap 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 datanya menggunakan JSON Object Notation JavaScript.
JSON adalah format internet umum yang menyediakan metode untuk merepresentasikan struktur data arbitrer. JSON adalah format teks yang sepenuhnya tidak bergantung pada bahasa, tetapi menggunakan konvensi yang familier bagi programmer bahasa C, termasuk C, C++, C#, Java, JavaScript, Perl, dan Python. |
| Format waktu | Semua tanggal ditampilkan dalam pengonversi Epoch dalam milidetik. Format ini berlaku untuk nilai waktu pembuatan langganan, waktu mulai dan berakhir komitmen paket, serta waktu berakhir uji coba gratis 30 hari. |