Sınırlar ve kotalar, Google altyapısını, Data Transfer API'yi 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 tasarlanmış bir sistemden kaynaklanabilir. Nedeni ne olursa olsun, belirli bir kaynaktan gelen trafiğin belirli bir seviyeye ulaştığında engellenmesi, Google Workspace sisteminin genel durumu için gereklidir. Bir geliştiricinin eylemlerinin topluluğu olumsuz yönde etkilememesini sağlar.
API isteği hataları
Çok düşük bir ihtimalle 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 var. Ayrıca 503 HTTP durum kodunda, hangi API kotalarının aşıldığını belirten hata bilgisi bulunuyor. Bu yanıtlar, özel uygulamanızın bu hataları algılayıp uygun işlemi gerçekleştirmesini sağlar.
İstekleri sabit bir süre içinde tamamlama
İsteklerinizin belirli bir süre içinde tamamlanması gerekiyorsa isteklerinizi paralel olarak gönderin veya Java ya da C# uygulamanızda birden fazla iş parçacığı kullanın. Örneğin, isteklerinizi aya veya başka bir döneme göre bölebilirsiniz. İleti dizileri söz konusu olduğunda, istek başına bir iş parçacığı olacak şekilde 10 ileti dizisiyle başlamayı deneyin. İleti dizisi önerisi, bazı ödünler içerir ve tüm API durumları için yararlı değildir. İstek sayısı çok yükselirse kota hataları ortaya çıkar.
Zamana dayalı hatalar
Zamana dayalı tüm hatalar (iş parçacığı başına X saniye için en fazla N şey), ö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. Bir iş parçacığı için Data Transfer API örneği, 5 saniye bekleyip başarısız çağrıyı yeniden denemektir. İstek başarılı olursa diğer iş parçacıkları için bu kalıbı tekrarlayın. İkinci istek başarılı olmazsa uygulamanız, bir çağrı başarılı olana kadar isteğin sıklığına göre ölçeği yeniden ölçeklendirmelidir. Örneğin, ilk 5 saniyelik gecikmeyi 10 saniyeye yükseltin ve başarısız olan çağrıyı 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 |
|---|---|
| Saniyedeki sorgu sayısı (QPS) | Geliştirici projesi sınırı, hesap başına saniyede 10 sorgu (QPS). |
Kotalar
| API kota kategorileri | Kotalar |
|---|---|
| Günlük maksimum API isteği sayısı | Günlük maksimum API isteği sayısı 500.000'dir. |
| İletilerin arşivlenmesi, geçerlilik süresi sonu | Grup arşivlerinin süresi dolmaz. İletiler grup silinene kadar arşivde kalır. E-posta saklama politikası bir grubun arşivindeki iletileri etkilemez. |
| Posta iletisi boyutu | Maksimum posta iletisi boyutu 25 MB'tır. Bu sınıra iletinin meta veri üstbilgileri, gövde metni ve tüm ekler dahildir. |
Diğer sınır türleri
| Diğer sınır türleri | Sınırlamalar ve yönergeler |
|---|---|
| İçerik türü biçimleri | E-posta mesajı, standart RFC 822 metin biçiminde olmalıdır.
Taşınan e-postaları yüklemek için isteğin içerik türü biçimi Content-type: message/rfc822 üst bilgisini kullanır.
|
| API yanıtlarındaki veri biçimi | Yanıtın veri biçimi JavaScript Object Notation (JSON) şeklindedir. |
| Veri konumu politikaları | Data Transfer API, verilerin sözleşmeden doğan nedenlerle belirli coğrafi veya politik sınırlarda depolanmasını gerektiren veri konumu politikalarını desteklemez. Hesabınız için veri konumu gerekiyorsa Data Transfer API'yi kullanmayın. |
| Paralel mesaj ekleme | Data Transfer API, farklı grup arşivlerine e-posta ekleme için paralel istekleri destekler. Ancak Data Transfer API, aynı grup arşivine paralel mesaj ekleme işlemlerini desteklemez. API'nin bu sürümünde toplu istekler de desteklenmez. |
| Yetkisiz istekler | Veri Aktarımı API'si yetkisiz istekleri kabul etmez. Yetkilendirme jetonu sağlanmazsa istekler yetkisiz olarak kabul edilir. |