Sınırlar ve kotalar, Google altyapısını Directory API'yi uygunsuz bir şekilde kullanan otomatik işlemlerden 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 sağlığı için gereklidir. Bir geliştiricinin eylemlerinin daha büyük topluluğu olumsuz etkilememesini sağlar.
API isteğinizin başarısız olması durumunda API, HTTP durum kodunu ve hatanın nedenini döndürür. Ayrıca, yanıtın gövde bölümünde hataya neyin neden olduğuna dair ayrıntılı bir açıklama yer alır.
Aşağıdaki listede, kota sınırlarına ulaşılmasından kaynaklanan hatalarla ilgili olası hata kodları, nedenler, açıklamalar ve önerilen işlemler gösterilmektedir.
| Kod | Neden | Açıklama | Önerilen işlem |
|---|---|---|---|
| 403 | userRateLimitExceeded | Kullanıcı hız sınırının aşıldığını gösterir. 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 üstel geri çekilme kullanarak istekleri gönderme hızınızı yavaşlatın. |
| 403 | quotaExceeded | Belirli bir işlem için eşzamanlı istek sınırına ulaşıldığını gösterir. | Eksponansiyel geri yükleme kullanarak yeniden deneyin. İstek gönderme hızınızı yavaşlatmanız gerekir. |
| 429 | rateLimitExceeded | Belirli bir işlem için eşzamanlı istek sınırına ulaşıldığını gösterir. | Eksponansiyel geri yükleme kullanarak yeniden deneyin. İstekleri gönderme hızınızı yavaşlatmanız gerekir. Bu sınır, API istemcisi veya kullanıcı başına değil, Google Workspace hesabı başına uygulanır. Bu sınır artırılamaz. |
Üstel Geri Alma Uygulama
Eksponansiyel geri yükleme, istemcinin başarısız olan bir isteği belirli aralıklarla artan bir süre boyunca yeniden deneme işlemidir. Bu, ağ uygulamaları için standart bir hata işleme stratejisidir. Üstel geri çekilme kullanmak 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üklemeyi uygulama akışı aşağıdaki gibidir.
- API'ye istek gönderme
- Yeniden denenebilir hata kodu içeren bir hata yanıtı alırsanız
- 1 saniye +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denenebilir hata kodu içeren bir hata yanıtı alırsanız
- 2 saniye +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denenebilir hata kodu içeren bir hata yanıtı alırsanız
- 4 saniye +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denenebilir hata kodu içeren bir hata yanıtı alırsanız
- 8 saniye +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denenebilir hata kodu içeren bir hata yanıtı alırsanız
- 16 saniye +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Hatayı almaya devam ederseniz durun ve hatayı kaydedin.
Yukarıdaki akışta random_number_milliseconds, 1.000'den küçük veya 1.000'e eşit rastgele bir milisaniye sayısıdır. Bu, bazı eşzamanlı uygulamalarda belirli kilit hatalarını önlemek için gereklidir.
Her beklemeden sonra random_number_milliseconds 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 ve her yinelemede (her istekte) 1 artan, monoton olarak artan bir tam sayıdır.
Algoritma, n 5 olduğunda sonlandırılacak şekilde ayarlanmıştır. Bu sınır yalnızca istemcilerin sonsuza kadar yeniden denemesini engellemek için uygulanır ve bir istek "kurtarılamayan bir hata" olarak kabul edilmeden önce toplamda yaklaşık 32 saniyelik bir gecikmeye neden olur. API istemciniz gerekirse 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 yayılması 10 dakika kadar sürebilir. Bir kullanıcının adını değiştirmeden önce, kullanıcının tüm tarayıcı oturumlarından ve hizmetlerden çıkış yapması önerilir. Daha fazla bilgi için Kullanıcıları güncelleme başlıklı makaleyi inceleyin. |
| Kuruluş birimleri oluşturma/güncelleme |
|
| API Kota Kategorileri | Kotalar |
Chrome cihazlar annotatedLocation, maksimum karakter sayısı
|
Cihazın konum bilgileri için maksimum karakter sayısı 200'dür. |
Chrome cihazlar notes, maksimum karakter sayısı
|
Bir cihazın not bilgileri için maksimum karakter sayısı 500'dür. |
Chrome cihazlar, maksimum user karakter
|
Cihaz kullanıcısının adı en fazla 100 karakter olabilir. |
| Maksimum alan takma adı sayısı | Maksimum alan adı takma adı sayısı 20'dir. |
| Gruplar, açıklama | Açıklamalardaki maksimum karakter sayısı 4.096'dır. |
| Hesap başına grup sayısı | G Suite'in eski ücretsiz sürümünü kullanan hesaplarda grup sayısı 10 ile sınırlıdır. Diğer sürümlerde grup sayısı sınırlı değildir. |
| Gruplar, grup başına üye sayısı | G Suite'in eski ücretsiz sürümünü kullanan hesaplarda bir grup en fazla 100 üye içerebilir. Diğer sürümlerde, bir grubun sahip olabileceği üye sayısı sınırlı değildir. Kullanıcı başına grup üyeliği sınırları için Gruplar politikalarını ve sınırlarını anlama başlıklı makaleyi inceleyin. |
| maxResults sorgu dizesi | API, aşağıdakileri döndürür:
|
| Birden fazla alan adı, bir hesapta izin verilen maksimum alan adı sayısı | 600 (1 birincil alan + 599 ek alan) |
| 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 hesapta mevcut olmalıdır. |
| Kullanıcı takma adları | Her kullanıcı hesabı için izin verilen toplam takma ad sayısı 30'dur. |
| Kullanıcı takma adları, silinmiş bir takma adı kullanma | Silinen kullanıcı takma adları hemen tekrar kullanılabilir. |
| Diğer Sınır Türleri | Sınırlamalar ve Yönergeler |
|---|---|
| Faturalandırma ve kullanıcı oluşturma | Google Workspace için esnek plan kullanan kullanıcılar için bu API kullanılarak oluşturulan kullanıcılar, parasal etkiye neden olur ve müşteri faturalandırma hesabınızdan ücret alınır. Örneğin, Google Workspace için esnek bir plan kullanıyorsanız 10 kullanıcı oluşturduğunuzda, oluşturma işlemi tamamlandıktan sonraki süreyle orantılı olarak 10 Google Workspace lisansı için hesabınıza ücret yansıtılır. Yıllık plan kullanıyorsanız belirli sayıda lisans için önceden ödeme yapmayı taahhüt etmişsinizdir ve yalnızca taahhüdünüzdeki kadar kullanıcı oluşturabilirsiniz. Faturalandırma planları ve faturalandırma hesabınız hakkında daha fazla bilgi için yönetim yardım merkezine bakın. |
| Ad ve Soyadı | Ad ve soyad en fazla 40 karakter uzunluğunda olabilir. 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 Merkezi'ne bakın. |
| Grupları silme | Bir grubun silinmesi, grup üyelerinin 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. Grup üyesinin e-posta adresini değiştirmek için Google Yönetici Konsolu'nu kullanın. Değişiklik yapıldıktan sonra API, e-posta adresi değişikliklerini otomatik olarak yansıtır. |
| Gruplar, ayarlar | Grupların erişim ayarları, paylaşım seçenekleri, izleme ve tartışma arşivi Google Yönetici Konsolu kullanılarak yönetilir. Grup ayarları hakkında daha fazla bilgi için yönetim yardım merkezine bakın. |
| Gruplar, mesaj gönderme | Google, spam ve e-posta kötüye kullanımını önlemek için 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 için E-posta gönderme sınırları ve Gmail kullanıcılarına ait postaların engellenmesini veya spam klasörüne gönderilmesini önleme başlıklı makaleleri inceleyin. |
| 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 bakın. |
| Kuruluş birimi, hizmetleri etkinleştirme/devre dışı bırakma | Kuruluş biriminde hizmetleri etkinleştirme ve devre dışı bırakma işlemlerini yönetmek için Google Yönetici Konsolu'nu kullanın. |
| Şifreler | Herhangi bir karakter kombinasyonunu içerebilir. En az 8 karakter olmalıdır. En çok 100 karakterden oluşabilir. |
| Fotoğraflar | API'nin bu sürümünde fotoğraf, kullanıcının en son Google profili fotoğrafıdır. |
| Kullanıcı adları | Kullanıcı adları harf (a-z), rakam (0-9), kısa çizgi (-) ve alt çizgi (_) içerebilir. Google Workspace, nokta (.) işaretini tanır. Bu, Gmail'de geçerli olanla aynı değildir. Kullanıcı adı eşittir işareti (=), büyüktür-küçüktür işareti (<,>) veya art arda birden fazla nokta (.) içeremez. Daha fazla bilgi için Yönetici Yardım Merkezi'ne bakın. |
| Kullanıcı adları, yeniden adlandırma | Google Hangouts, yeniden adlandırmanın ardından hatırlanan tüm sohbet davetlerini siler. Kullanıcının arkadaşlarıyla tekrar sohbet etmek için izin istemesi gerekir. Eski kullanıcı adı, e-posta yönlendirme ayarları durumunda posta dağıtımının kesintisiz olmasını sağlamak için e-posta takma adı olarak tutulur ve yeni kullanıcı adı olarak kullanılamaz. Kullanıcıları yeniden adlandırmanın etkisiyle ilgili önemli ayrıntılar için yönetim yardım merkezine bakı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 fazla alandaki kullanıcılar | Google Workspace hesabınızda alanlarınızın tümü yer alabilir. Çok alanlı bir hesapta, bir alandaki kullanıcılar hizmetleri diğer hesap alanlarındaki kullanıcılarla paylaşabilir. Birden fazla alan bileşeni şunlardır:
|
| Uyarılar, grup üyeleri | GROUP_CANNOT_CONTAIN_CYCLE: API, grup üyeliklerinde döngüye izin vermez. Örneğin, grup1, grup2'nin üyesiyse grup2, grup1'in üyesi olamaz. |