Sınırlar ve kotalar, Google altyapısını, Bayi API'sini uygun olmayan bir şekilde kullanan otomatik bir işlemden korur. Bir API'den gelen aşırı istekler, zararsız bir yazım hatasından veya gereksiz API çağrıları yapan verimsiz bir sistemden kaynaklanabilir. Nedeni ne olursa olsun, belirli bir kaynaktan gelen trafiğin belirli bir düzeye ulaştığında engellenmesi, Google Workspace sisteminin genel durumu için gereklidir. Bir geliştiricinin eylemlerinin topluluk üzerinde olumsuz bir etki yaratmamasını sağlar.
API isteği hataları
Çok düşük bir ihtimal de olsa API isteğinizin başarısız olması durumunda uygulamanız bir HTTP durum kodu yanıtı alır. 403 durum kodunda yanlış girişle ilgili hata bilgisi, 503 HTTP durum kodu ise hangi API kotalarının aşıldığını belirten hata bilgisi içerir. Bu yanıtlar, özel uygulamanızın bu hataları algılayıp gerekli işlemi yapmasına olanak tanır.
Zamana dayalı hatalar
Zamana dayalı tüm hatalar (iş parçacığı başına N saniyede en fazla N öğe), özellikle 503 durum kodu hataları için kodunuzun istisnayı yakalamasını ve üstel geri yükleme algoritması kullanarak başarısız çağrıyı yeniden denemeden önce kısa bir süre beklemenizi öneririz. Tek iş parçacığına yönelik bir Bayi API'si örneği, 5 saniye bekleyip başarısız çağrıyı yeniden denemektir. İstek başarılı olursa bu kalıbı diğer iş parçacıkları için tekrarlayın. İkinci istek başarılı değilse uygulamanız, bir arama başarılı olana kadar isteğin sıklığını azaltmalıdır. Örneğin, ilk 5 saniyelik gecikmeyi 10 saniyeye yükselterek başarısız çağrınızı tekrar deneyin. Ayrıca, bir yeniden deneme sınırı belirleyin.
Örneğin, uygulamanız kullanıcıya hata döndürmeden önce bir isteği farklı gecikme süreleriyle 5-7 kez yeniden deneyin.
Sınırlar
| API sınır kategorileri | Sınırlar |
|---|---|
purchaseOrderId aboneliği |
Bu mülk en fazla 80 düz metin karakterini kabul eder. |
maxResults aboneliği |
maxResults sorgu dizesi 1 ila 100 sonuç olabilir.
Varsayılan olarak 20 sonuç gösterilir.
|
Aktarım Jetonu (customerAuthToken) |
Müşterinin aktarım jetonu, jeton oluşturulduktan sonraki 30 gün boyunca geçerlidir. |
| Müşteri için 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 kullanıcı olabilir. |
| Yetkisiz istekler | Google, Bayi API'sine yetkisiz istekler yapılmasına izin vermez. Yetkilendirme jetonu sağlanmazsa istekler yetkisiz olarak değerlendirilir. Daha fazla bilgi için Kimlik doğrulama ve yetkilendirme hakkında bilgi bölümüne bakın. |
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 biçimindedir.
JSON, rastgele veri yapılarını temsil etme yöntemi sağlayan yaygın bir internet biçimidir. JSON, tamamen dilden bağımsız olan ancak C, C++, C#, Java, JavaScript, Perl ve Python gibi C dil ailesinin programcılarının aşina olduğu kuralları kullanan bir metin biçimidir. |
| Saat biçimi | Tüm tarih saatleri, milisaniye cinsinden Epoch dönüştürücüsünde yer alır. Bu biçim; abonelik oluşturma zamanı, planın taahhüt başlangıç ve bitiş zamanları ile 30 günlük ücretsiz denemenin bitiş zamanı için geçerlidir. |