Sınırlar ve kotalar, Google altyapısını, Directory API'yi uygun olmayan ş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.
Çok düşük bir ihtimal de olsa API isteğinizin başarısız olması durumunda API bir HTTP durum kodu ve hatanın nedenini döndürür. Ayrıca, yanıtın gövdesinde hatanın nedenine dair ayrıntılı bir açıklama yer alır.
Aşağıdaki listede, kota sınırlarına ulaşılmasından kaynaklanan hatalar için olası hata kodları, nedenler, ilgili açıklamalar ve önerilen işlemler gösterilmektedir.
| Kod | Neden | Açıklama | Önerilen işlem |
|---|---|---|---|
| 403 | userRateLimitExceeded | Kullanıcı oranı sınırının aşıldığını belirtir. Google Cloud Console'da ayarlanan varsayılan değer,Google Cloud projesi başına kullanıcı başına dakikada 2.400 sorgudur. | Google Cloud projenizin Admin SDK API Kotaları sayfasından kullanıcı başına sınırları artırın veya eksponansiyel geri yükleme kullanarak istekleri gönderme hızınızı düşürün. |
| 403 | quotaExceeded | Belirli bir işlem için eşzamanlı istek sınırına ulaşıldığını belirtir. | Üstel geri çekilme yöntemini kullanarak yeniden deneyin. İstekleri gönderme hızınızı azaltmanız gerekir. |
| 429 | rateLimitExceeded | Belirli bir işlem için eşzamanlı istek sınırına ulaşıldığını belirtir. | Eksponansiyel geri çekme kullanarak yeniden deneyin. İstekleri gönderme hızınızı azaltmanız gerekir. Bu sınır API istemcisi veya kullanıcı başına değil, Google Workspace hesabı başına belirlenir. Bu sınır artırılamaz. |
Üstel Geri Alma Uygulama
Eksponansiyel geri yükleme, istemcinin başarısız bir isteği giderek artan bir süre boyunca düzenli olarak yeniden denemesi işlemidir. Bu, ağ uygulamaları için standart bir hata işleme stratejisidir. Eksponansiyel geri yükleme kullanımı bant genişliği kullanımının verimliliğini artırır, başarılı bir yanıt almak için gereken istek sayısını azaltır ve eşzamanlı ortamlarda isteklerin işleme hızını en üst düzeye çıkarır.
Basit eksponansiyel geri yükleme uygulama akışı aşağıdaki gibidir.
- API'ye istekte bulunma
- Yeniden denenebilir hata kodu içeren bir hata yanıtı al
- 1 sn +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denenebilir hata kodu içeren bir hata yanıtı al
- 2 sn +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denenebilir hata kodu içeren bir hata yanıtı al
- 4 sn +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denenebilir hata kodu içeren bir hata yanıtı al
- 8 sn +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denenebilir hata kodu içeren bir hata yanıtı al
- 16 sn +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Hâlâ hata alıyorsanız hatayı durdurun ve günlüğe kaydedin.
Yukarıdaki akışta random_number_milliseconds, 1.000'den küçük veya 1.000'e eşit olan rastgele bir milisaniye sayısıdır. Eşzamanlı bazı uygulamalarda belirli kilitleme hatalarını önlemek için bu gereklidir.
random_number_milliseconds her beklemeden sonra yeniden tanımlanmalıdır.
Not: Bekleme süresi her zaman (2 ^ n) + random_number_milliseconds'dir. Burada n, başlangıçta 0 olarak tanımlanan tekdüze şekilde artan bir tam sayıdır. n, her iterasyonda (her istek) 1 artar.
Algoritma, n 5 olduğunda sonlandırılacak şekilde ayarlanır. Bu üst sınır yalnızca istemcilerin sonsuza kadar yeniden denemesini durdurmak için uygulanır ve bir istek "kurtarılamaz hata" olarak kabul edilmeden önce toplamda 32 saniyelik bir gecikmeyle sonuçlanır. Gerekirse API istemciniz daha fazla deneme uygulayabilir.
API Sınırları ve Kotaları
| API Sınır Kategorileri | Sınırlar |
|---|---|
| Kullanıcı oluşturma | Directory API'yi kullanarak alan başına saniyede 10'dan fazla kullanıcı oluşturamazsınız. |
| Grup, başka bir gruba üye olarak eklendi | Alt grubun üyelerinin üst grubun üyeleri olarak görünmesi 10 dakikayı bulabilir. Bu sınır, sistemin kapasitesine bağlı olarak değişebilir. |
| Mobil cihazlar |
Directory API'yi kullanarak şunları yapabilirsiniz:
|
| Kullanıcıları yeniden adlandırma | Tüm hizmetlere uygulanması 10 dakika kadar sürebilir. Bir kullanıcıyı yeniden adlandırmadan önce kullanıcının tüm tarayıcı oturumlarını ve hizmetlerini kapatmanız önerilir. Diğer ayrıntılar için Kullanıcıları güncelleme başlıklı makaleyi inceleyin. |
| Kuruluş Birimleri Oluşturma/Güncelleme |
|
| API Kota Kategorileri | Kotalar |
annotatedLocation Chrome cihazlar, maks. karakter
|
Bir cihazın konum bilgisi için maksimum karakter sayısı 200'dür. |
notes Chrome cihazlar, maks. karakter
|
Bir cihazın not bilgileri için maksimum karakter sayısı 500'dür. |
Chrome cihazlar, maksimum user karakter
|
Cihaz kullanıcısı adı için maksimum karakter sayısı 100'dür. |
| Alan takma adları, maksimum | Maksimum alan takma adı sayısı 20'dir. |
| Gruplar, açıklama | Bir açıklamada en fazla 4.096 karakter bulunabilir. |
| Grup, hesap başına | G Suite'in eski ücretsiz sürüm hesaplarında grup sayısı 10 ile sınırlıdır. Diğer sürümlerde grup sayısı sınırı yoktur. |
| Gruplar, grup başına üye sayısı | G Suite'in eski ücretsiz sürüm hesaplarında bir grupta en fazla 100 üye olabilir. Diğer sürümlerde bir grubun sahip olabileceği üye sayısı için bir sınır yoktur. Kullanıcı başına grup üyeliği sınırları hakkında bilgi edinmek için Grup politikalarını ve sınırlamalarını anlama başlıklı makaleyi inceleyin. |
| maxResults sorgu dizesi | API şunları döndürür:
|
| Birden fazla alan, bir hesapta izin verilen maksimum alan sayısı | 600 (1 birincil alan + 599 ek alan adı) |
| Kuruluş Birimi, tek seferde taşınan maksimum kullanıcı sayısı | Tek seferde 20 kullanıcı taşınabilir. Ayrıca kullanıcının birincil e-posta adresleri de hesapta mevcut olmalıdır. |
| Kullanıcı takma adları | Her kullanıcı hesabı için izin verilen toplam takma ad sayısı 30'dur. |
| Silinen bir takma ad kullanılarak oluşturulan kullanıcı takma adları | Silinen kullanıcı takma adı hemen tekrar kullanılabilir. |
| Diğer Sınır Türleri | Sınırlamalar ve Kurallar |
|---|---|
| Faturalandırma ve kullanıcı oluşturma | Google Workspace'te esnek plan kullanan kullanıcılar için bu API'yi kullanarak kullanıcı oluşturmanın maddi etkisi olur ve müşteri faturalandırma hesapları için ücret alınmasına neden olur. Örneğin, Google Workspace için esnek bir plan kullanıyorsanız 10 kullanıcı oluşturmak, 10 Google Workspace lisansı için oluşturma işleminin yapıldığı andan itibaren eşit olarak hesaplanan bir ücretin hesabınıza gönderilmesine neden olur. Yıllık plan kullanıyorsanız, önceden belirli sayıda lisans için ödeme yapmayı taahhüt etmiş olursunuz ve yalnızca taahhüdünüze uygun sayıda kullanıcı oluşturabilirsiniz. Faturalandırma planları ve faturalandırma hesabınız hakkında daha fazla bilgi edinmek için yönetim yardım merkezine göz atın. |
| Ad ve Soyadı | Ad ve soyadları en fazla 40 karakterden oluşabilir. Unicode/UTF-8 karakterlerini destekler ve boşluk, harf (a-z), rakam (0-9), kısa çizgi (-), eğik çizgi (/) ve nokta (.) içerebilir. Karakter kullanım kuralları hakkında daha fazla bilgi için yönetim yardım merkezine bakın. |
| Gruplar, siliniyor | Bir grubun silinmesi, grup üyesinin kullanıcı hesaplarının silinmesine neden olmaz. |
| Gruplar ve grup üyeleri, e-posta adresi değişikliği | API'nin bu sürümünde, Google Workspace hizmeti etkinleştirilmeden önce bir grubun e-posta adresi değiştirilebilir. Bir grup üyesinin e-posta adresini değiştirmek için Yönetici konsolunu kullanın. API, değiştirildiğinde e-posta adresi değişikliklerini otomatik olarak yansıtır. |
| Gruplar, ayarlar | Gruplar erişim ayarları, paylaşım seçenekleri, izleme ve tartışma arşivi Yönetici konsolu kullanılarak yönetilir. Grup ayarları hakkında daha fazla bilgi edinmek için yönetim yardım merkezine göz atın. |
| Gruplar, ileti gönderme | Spam ve e-postaların kötüye kullanılmasını engellemek için Google, harici alıcılara tek seferde gönderebileceğiniz ileti sayısını sınırlar. Bir gruba ileti gönderirseniz her harici üye bir alıcı olarak sayılır. Daha fazla bilgi edinmek için E-posta gönderme sınırları ve Gmail kullanıcılarına giden postaların engellenmesini veya spam klasörüne gönderilmesini önleme başlıklı makalelere göz atın. |
| Gruplar, NDR iletileri gönderme | "Geri dönen iletiler" olarak da bilinen teslim edilemedi bilgilerini bir gruba gönderemez veya yönlendiremezsiniz. |
| Kullanıcılar tarafından oluşturulan gruplar, sınırlamalar | Kullanıcı tarafından oluşturulan grup sınırları için yönetim yardım merkezine göz atın. |
| Hizmetleri etkinleştiren/devre dışı bırakan Kuruluş Birimi | Bir kuruluş biriminde hizmetleri etkinleştirme ve devre dışı bırakma işlemlerini yönetmek için Yönetici konsolunu kullanın. |
| Şifreler | Herhangi bir karakter kombinasyonunu içerebilir. En az 8 karakter gereklidir. En çok 100 karakter kullanılabilir. |
| Fotoğraflar | API'nin bu sürümünde fotoğraf, kullanıcının en son Google profil fotoğrafıdır. |
| Kullanıcı adları | Kullanıcı adları harf (a-z), rakam (0-9), kısa çizgi (-), alt çizgi (_) içerebilir ve Google Workspace noktaları veya noktaları (.) tanır. Gmail ile aynı şey değildir. Kullanıcı adında eşittir işareti (=), ayraç (<,>) veya art arda birden fazla nokta (.) bulunamaz. Daha fazla bilgi edinmek için yönetim yardım merkezine bakın. |
| Kullanıcı adları, yeniden adlandırma | Google Hangouts, yeniden adlandırma işleminden sonra hatırlanan tüm sohbet davetiyelerini siler. Kullanıcının, arkadaşlarıyla tekrar sohbet etmek için izin istemesi gerekir. E-posta yönlendirme ayarlarında posta dağıtımının kesintisiz olmasını sağlamak için eski kullanıcı adı e-posta takma adı olarak saklanır ve yeni bir kullanıcı adı olarak kullanılamaz. Kullanıcıları yeniden adlandırma işleminin etkisiyle ilgili önemli ayrıntılar için yönetim yardım merkezine göz atın. Yeniden adlandırma işleminden sonra e-posta takma adını kaldırmak için Kullanıcının takma adını silme işlemini kullanın. |
| Birden çok alan adındaki kullanıcılar | Bir Google Workspace hesabı, alanlarınızın herhangi birini içerebilir. Birden fazla alan adı hesabında, bir alan adındaki kullanıcılar hizmetleri başka hesap alan adlarındaki kullanıcılarla paylaşabilir. Birden fazla alan bileşeni şunlardır:
|
| Uyarılar, grup üyeleri | GROUP_CANNOT_CONTAIN_CYCLE – API, grup üyeliklerinde bir döngüye izin vermiyor. Örneğin, grup1 grup2'nin üyesiyse grup2, grup1'in üyesi olamaz. |