Sınırlar ve kotalar, Google altyapısını, Groups Migration 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 düzeye ulaştıktan sonra engellenmesi, Google Workspace sisteminin genel durumu için gereklidir.
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 HTTP durum kodunda, yanlış girişle ilgili hata bilgisi var ve 503 HTTP durum kodunda hangi API kotalarının aşıldığını belirten hata bilgileri bulunuyor. Bu yanıtlar, özel uygulamanızın bu hataları algılayıp gerekli işlemi yapmasını sağlar.
Zamana duyarlı istekler
İsteklerinizin sabit 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 ileti dizisi 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
Süreye 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 Groups Migration API'ye örnek olarak 5 saniye bekleyip başarısız çağrıyı yeniden deneyin. İ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 yeniden ölçeklendirme yapmalıdır. Ö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ğinde, 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ırlar | 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üklerken isteğin içerik türünde Content-type: message/rfc822 üst bilgisi kullanılmalıdır.
|
| API yanıtlarındaki veri biçimi | Yanıtın veri biçimi JavaScript Object Notation (JSON) şeklindedir. |
| Veri konumu politikaları | Groups Migration API, verilerin sözleşmeden kaynaklanan nedenlerle belirli coğrafi veya siyasi sınırlarda depolanmasını gerektiren veri konumu politikalarını desteklemez. Hesabınız için veri konumu gerekiyorsa Groups Migration API'yi kullanmayın. |
| Paralel mesaj ekleme | Groups Migration API, farklı grup arşivlerine e-posta ekleme için paralel istekleri destekler. Ancak Groups Migration API, aynı grup arşivine paralel mesaj ekleme işlemlerini desteklemez. Ayrıca, toplu istekler Groups Migration API'nin bu sürümünde desteklenmemektedir. |
| Yetkisiz istekler | Groups Migration API, yetkisiz istekleri kabul etmez. Yetkilendirme jetonu sağlanmazsa istekler yetkisiz olarak kabul edilir. Daha fazla bilgi için Kimlik doğrulama ve yetkilendirme hakkında bilgi bölümüne bakın. |