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ı isteklerin nedeni, zararsız bir yazım hatası veya gereksiz API çağrıları yapan, verimsiz bir şekilde tasarlanmış bir sistem olabilir. Nedeni ne olursa olsun, belirli bir düzeye ulaşan belirli bir kaynaktan gelen trafiğin engellenmesi Google Workspace sisteminin genel sağlığı için gereklidir. Bu sayede, bir geliştiricinin eylemleri daha geniş bir topluluğu olumsuz yönde etkileyemez.
API isteğinizin başarısız olması ihtimaline karşı API, bir HTTP durum kodu ve hatanın nedenini döndürür. Ayrıca, yanıtın gövdesinde hataya neyin neden olduğuna dair ayrıntılı bir açıklama bulunur.
Aşağıdaki listede, kota sınırlarına ulaşılmasından kaynaklanan hataların olası hata kodları, nedenleri, ilgili açıklamaları ve önerilen işlemleri gösterilmektedir.
| Kod | Neden | Açıklama | Önerilen işlem |
|---|---|---|---|
| 403 | userRateLimitExceeded | Kullanıcı oranı sınırının aşıldığını gösterir. Google Cloud Console'da belirlenen varsayılan değer,Google Cloud projesi başına kullanıcı başına dakikada 2.400 sorgudur. | Google Cloud projenizin Yönetici SDK'sı API Kotaları sayfasından kullanıcı başına sınırları artırın veya üssel geri çekilme kullanarak istek 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. | Üstel geri yükleme kullanarak yeniden deneyin. İstekleri 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 özelliğini kullanarak yeniden deneyin. İstekleri gönderme hızını yavaşlatmanız gerekir. Bu sınır, API istemcisi veya kullanıcı başına değil, Google Workspace hesabı başınadır. Bu sınır artırılamaz. |
Üstel Geri Alma Uygulama
Eksponansiyel geri yükleme, istemcinin başarısız bir isteği belirli aralıklarla tekrar denediği ve bu süreyi kademeli olarak uzattığı işlemdir. Bu, ağ uygulamaları için standart bir hata işleme stratejisidir. Eksponansiyel geri yükleme 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ı ortamlardaki 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 denemeye uygun bir hata kodu içeren bir hata yanıtı alma
- 1 saniye +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denemeye uygun bir hata kodu içeren bir hata yanıtı alma
- 2 saniye +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denemeye uygun bir hata kodu içeren bir hata yanıtı alma
- 4 saniye +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denemeye uygun bir hata kodu içeren bir hata yanıtı alma
- 8 saniye +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Yeniden denemeye uygun bir hata kodu içeren bir hata yanıtı alma
- 16 saniye +
random_number_millisecondssaniye bekleyin - İsteği yeniden dene
- Hata almaya devam ederseniz işlemi durdurup hatayı günlüğe kaydedin.
Yukarıdaki akışta random_number_milliseconds, 1000'den küçük veya 1000'e eşit rastgele bir milisaniye sayısıdır. Bu, bazı eşzamanlı uygulamalarda belirli kilitleme hatalarını önlemek için gereklidir.
random_number_milliseconds her bekleme işleminden sonra yeniden tanımlanmalıdır.
Not: Beklemenin değeri her zaman (2 ^ n) + random_number_milliseconds şeklindedir. Burada n, başlangıçta 0 olarak tanımlanan monoton bir şekilde artan bir tam sayıdır. n, her iterasyonda (her istek) 1 artar.
Algoritma, n 5 olduğunda sonlandırılacak şekilde ayarlanmıştır. Bu üst sınır, istemcilerin sonsuza kadar yeniden denemesini önlemek için belirlenmiştir ve bir isteğin "kurtarılamaz hata" olarak değerlendirilmesinden önce toplam 32 saniyelik bir gecikmeye neden olur. API istemciniz gerekirse daha fazla deneme uygulayabilir.
API Sınırlılıkları ve Kotaları
| API Sınırı Kategorileri | Sınırlar |
|---|---|
| Kullanıcı oluşturma | Directory API'yi kullanarak saniye başına alan başına 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 | Değişikliklerin tüm hizmetlere yayılması 10 dakikayı bulabilir. Bir kullanıcının adını değiştirmeden önce kullanıcının tüm tarayıcı oturumlarından ve hizmetlerinden çıkış yapması önerilir. Daha fazla bilgi için Kullanıcıları güncelleme başlıklı makaleyi inceleyin. |
| Kuruluş birimi oluşturma/güncelleme |
|
| API Kotası Kategorileri | Kotalar |
Chrome cihazlar annotatedLocation, maksimum karakter sayısı
|
Bir 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ı için maksimum karakter sayısı 100'dür. |
| Maksimum alan takma adı sayısı | Maksimum alan adı takma adı sayısı 20'dir. |
| Gruplar, açıklama | Açıklamadaki maksimum karakter sayısı 4.096'dır. |
| Hesap başına grup sayısı | G Suite'in eski ücretsiz sürümünü kullanan hesaplar 10 grup oluşturabilir. Diğer sürümlerde grup sayısı sınırsızdır. |
| Gruplar, grup başına üye sayısı | G Suite'in eski ücretsiz sürümünü kullanan hesaplar 100 adede kadar üye içerebilir. Diğer sürümlerde grupların sahip olabileceği üye sayısı sınırsızdır. Kullanıcı başına grup üyeliği sınırları için Gruplar politikalarını ve sınırlamalarını anlama başlıklı makaleyi inceleyin. |
| maxResults sorgu dizesi | API şu bilgileri döndürür:
|
| Birden fazla alan, bir hesapta izin verilen maksimum alan sayısı | 600 (1 birincil alan + 599 ek alan) |
| Kuruluş birimi, bir seferde taşınabilecek maksimum kullanıcı sayısı | Tek seferde 20 kullanıcı taşınabilir. Ayrıca, kullanıcının birincil e-posta adresleri hesapta zaten 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ı kullanan kullanıcı takma adları | 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'in esnek planını kullananlar için bu API'yi kullanarak kullanıcı oluşturmak maddi açıdan etkili olacak ve müşteri faturalandırma hesabınızdan ödeme alınmasına neden olacaktır. Örneğin, Google Workspace için esnek bir plan kullanıyorsanız 10 kullanıcı oluşturduğunuzda, hesapnıza 10 Google Workspace lisansı için ödeme yapılır. Bu ödeme, hesabın oluşturulduğu tarihten itibaren oransal olarak hesaplanır. Yıllık plan kullanıyorsanız önceden belirli sayıda lisans için ödeme yapmayı taahhüt etmişsiniz demektir ve yalnızca taahhüt ettiğiniz sayıda 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 göz atın. |
| Ad ve Soyadı | Ad ve soyadlar 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 merkezine 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, bir grubun e-posta adresi Google Workspace hizmeti etkinleştirilmeden önce değiştirilebilir. Grup üyelerinin e-posta adresini değiştirmek için 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 | Grup 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 için yönetim yardım merkezine göz atı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ırlandırır. 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 mesajları gönderme | "Geri dönen iletiler" olarak da bilinen teslim edilemedi bilgilerini (NDR) 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. |
| Kuruluş birimi, hizmetleri etkinleştirme/devre dışı bırakma | Bir kuruluş birimi için hizmetleri etkinleştirme ve devre dışı bırakma işlemlerini Yönetici Konsolu'nu kullanarak yönetebilirsiniz. |
| Şifreler | Herhangi bir karakter kombinasyonu içerebilir. En az 8 karakter gereklidir. Maksimum uzunluk 100 karakterdir. |
| 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. Google Workspace, noktaları (.) tanır. Bu, Gmail ile aynı değildir. Kullanıcı adlarında eşittir (=), köşeli ayraç (<,>) veya art arda birden fazla nokta (.) olamaz. Daha fazla bilgi için yönetim yardım merkezine göz atın. |
| Kullanıcı adları, yeniden adlandırma | Google Hangouts, yeniden adlandırma işleminden sonra hatırlanan tüm sohbet davetlerini siler. Kullanıcının, arkadaşlarıyla sohbet etmek için tekrar 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 tutulur ve yeni kullanıcı adı olarak kullanılamaz. Kullanıcıların adını değiştirmenin 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ı takma adını silme işlemini kullanın. |
| Birden fazla alandaki kullanıcılar | Google Workspace hesabı, alanlarınızdan herhangi birini içerebilir. Birden fazla alan içeren hesaplarda, bir alandaki kullanıcılar diğer hesap alanlarındaki kullanıcılarla hizmet 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, group1 grubu group2 grubunun üyesiyse group2 grubu group1 grubunun üyesi olamaz. |