Sınırlar ve kotalar, Google altyapısını Reseller API'yi uygunsuz şekilde kullanan otomatik süreçlerden korur. Aşırı istekler, yazım hatasından veya verimsiz bir sistem tasarımından kaynaklanabilir. Google, Google Workspace sisteminin sorunsuz çalışmasını sağlamak için belirli bir düzeye ulaştığında belirli kaynaklardan gelen trafiği engeller. Bu sayede, bir geliştiricinin eylemlerinin topluluğu olumsuz etkilememesi sağlanır.
API istek hataları
Bir API isteği başarısız olursa uygulamanız bir HTTP durum kodu alır. 403 durum kodu yanlış giriş yapıldığını, 503 durum kodu ise API kotalarının aşıldığını gösterir. Hataları tespit etmek ve işlem yapmak için bu yanıtları kullanın.
Zamana dayalı hatalar
Zamana dayalı hatalar (özellikle 503 durum kodları) için eksponansiyel geri yükleme algoritması kullanın. Başarısız olan aramayı yeniden denemeden önce kısa bir süre bekleyin. Örneğin, 5 saniye bekleyip tekrar deneyin. Başarılı olursa diğer iş parçacıkları için de bu işlemi tekrarlayın. İkinci istek başarısız olursa bir çağrı başarılı olana kadar istek sıklığını azaltın. Yeniden deneme sınırı (ör. 5-7 kez) belirlemeniz de önerilir.
Sınırlar
| API sınır kategorileri | Sınırlar |
|---|---|
Abonelik purchaseOrderId |
Bu özellik en fazla 80 düz metin karakteri kabul eder. |
Abonelik maxResults |
maxResults sorgu dizesi 1-100 sonuç içerebilir.
Varsayılan olarak 20 sonuç gösterilir.
|
Aktarım jetonu (customerAuthToken) |
Müşterinin aktarım jetonu, oluşturulduktan sonra 30 gün boyunca geçerlidir. |
| Müşteri başına maksimum kullanıcı sayısı | Sözleşmenize bağlı olarak, maksimum kullanıcı sayısı 50.000 veya bayi sözleşmenizde tanımlanan maksimum sayı olabilir. |
| Yetkisiz istekler | Google, Bayi API'sine yetkisiz istek gönderilmesine izin vermez. Yetkilendirme jetonu sağlanmazsa istek yetkisizdir. Daha fazla bilgi için Kimlik doğrulama ve yetkilendirme hakkında başlıklı makaleyi inceleyin. |
Diğer sınır türleri
| Diğer sınır türleri | Sınırlamalar ve yönergeler |
|---|---|
| Veri biçimi |
Veri biçimi JavaScript Object Notation
(JSON) olmalıdır.
JSON, rastgele veri yapılarını temsil etmek için kullanılan yaygın bir internet biçimidir. C, C++, C#, Java, JavaScript, Perl ve Python gibi C ailesi dillerinin programcılarına tanıdık gelen kuralları kullanan, dilden bağımsız bir metin biçimidir. |
| Saat biçimi | Tarihler ve saatler milisaniye cinsinden Epoch dönüştürücüyü kullanır. Bu biçim, abonelik oluşturma zamanı, plan taahhüdü başlangıç ve bitiş zamanları ile ücretsiz deneme bitiş zamanları için geçerlidir. |