İstek Hataları
Classroom API hataları, hatanın nedenini belirlemenize ve hatayı doğru şekilde ele almanıza yardımcı olacak bir hata kodu içerebilir. Koda bağlı olarak isteği yeniden deneyebilir veya kullanıcıları belirli bir işlem yapmaya yönlendirebilirsiniz.
Bu sayfada, HTTP koduna göre gruplandırılmış olası hata kodları ayrıntılı olarak açıklanmıştır. Hata mesajının yapısı hakkında daha fazla bilgi edinmek için Hata Mesajı Yapısı başlıklı makaleyi inceleyin.
Bu sayfada, HTTP koduna göre gruplandırılmış olası hata kodları ayrıntılı olarak açıklanmıştır. Hangi yöntemlerin belirli bir hata kodu döndürdüğünü belirlemek için referans dokümanlarına bakın.
HTTP 400: FAILED_PRECONDITION
Kullanıcı, bir sınıra ulaştığı veya CourseNotModifiable gibi bir uygulama durumunda olduğu için izin verilemeyen bir işlem yapmaya çalıştığında FAILED_PRECONDITION döndürülür. FAILED_PRECONDITION hatasını düzeltmek için kullanıcıya bazı işlemleri yapmasını ve ardından tekrar denemesini söyleyin. Bazı durumlarda, durumu kullanıcı adına düzeltmek için alternatif uç noktalar da kullanabilirsiniz.
PendingInvitationExists
PendingInvitationExists, dersin sahipliğini almaya davet edilmiş bir kullanıcı olduğunu gösterir. Bu hata, daha önce başlatılmış ancak yeni sahip tarafından henüz kabul edilmemiş bir kurs sahipliği aktarımı sırasında ortaya çıkar.
CourseMemberLimitReached
CourseMemberLimitReached, denenen işlemin izin verilen maksimum kurs üyesi sayısını aşacağını gösterir. Bu kod genellikle students.create() tarafından döndürülür. Daha fazla bilgi için Sınıfa öğrenci davet etme başlıklı Yardım Merkezi makalesinin "Sınıf boyutu sınırları" bölümüne bakın.
Olası işlem: Hatanın nedenini açıklayın ve kullanıcının gereksiz kurs üyelerini kaldırmasını önerin
CourseNotModifiable
CourseNotModifiable, ilgili dersin özelliklerinin değiştirilmesine izin vermeyen bir durumda olduğunu (ders durumu hariç) gösterir.
Olası işlem: Kullanıcıdan dersi değiştirilebilir bir ders durumuna geçirmesini isteyin. Durumu değiştirmek için courses.patch() simgesini kullanın. Ders durumu, diğer özellikleri değiştiren bir istekte değiştirilebilir.
CourseTeacherLimitReached
CourseTeacherLimitReached, istenen işlemin izin verilen maksimum kurs öğretmeni sayısını aşacağını gösterir. Bu kod genellikle teachers.create() yöntemi tarafından döndürülür. Daha fazla bilgi için Sınıfa yardımcı öğretmen ekleme yardım merkezi makalesinin "Sınıf boyutu sınırlamaları" bölümünü inceleyin.
Olası işlem: Hatanın nedenini açıklayın ve kullanıcının gereksiz kurs öğretmenlerini kaldırmasını önerin. Uygulamanız için geçerliyse öğretmen listelerini kullanıcı adına yönetmek üzere teachers.delete() yöntemini kullanabilirsiniz.
CourseTopicLimitReached
CourseTopicLimitReached, istenen işlemin bir kurstaki izin verilen maksimum konu sayısını aşacağını gösterir. Bu kod genellikle courses.topics.create() yöntemi tarafından döndürülür.
Olası işlem: Hatanın nedenini açıklayın ve kullanıcıya gereksiz konuları kaldırmasını önerin. Uygulamanız için geçerliyse konuları kullanıcı adına yönetmek üzere courses.topics.delete() yöntemini kullanabilirsiniz.
UserGroupsMembershipLimitReached
UserGroupsMembershipLimitReached, kullanıcının izin verilen maksimum grup sayısına ulaştığını ve hiçbir kursa katılamayacağını gösterir. Bu kod genellikle students.create() veya teachers.create() tarafından döndürülür. Daha fazla bilgi için Sınıfa öğrenci davet etme yardım merkezi makalesinin "Sınıf boyutu sınırlamaları" bölümüne bakın.
Olası işlem: Hatanın nedenini açıklayın ve kullanıcının katılmadığı tüm kurslardan ayrılmasını önerin. Kullanıcı, daha fazla kursa katılması gerekiyorsa ek hesap oluşturabilir. Uygulamanız için geçerliyse kullanıcı adına listeleri yönetmek için students.create() veya teachers.delete() iznini kullanabilirsiniz.
AttachmentNotVisible
AttachmentNotVisible, belirtilen bir veya daha fazla eki kullanıcının göremediğini, istenen türde olmadığını ya da mevcut olmadığını gösterir. Örneğin, kullanıcıyla paylaşılmayan Drive öğeleri bu hatayı döndürür.
Olası işlem: Hatanın nedenini açıklayın ve kullanıcının eklediği tanımlayıcıları (ör. Drive dosya kimlikleri) yeniden kontrol etmesini önerin. Ayrıca, kullanıcının eki görüntülemek için uygun izinlere sahip olduğundan emin olun.
CannotRemoveCourseFolderOwner
CannotRemoveCourseFolderOwner, kurs Drive klasörünün sahibinin kaldırılamayacağını gösterir.
Olası işlem: Hatanın nedenini açıklayın ve kullanıcının kurs Drive klasörünün sahipliğini farklı bir kullanıcıya aktarmasını ve tekrar denemesini önerin.
CannotRemoveCourseOwner
CannotRemoveCourseOwner, kurs sahibinin kaldırılamayacağını gösterir.
Olası işlem: Hatanın nedenini açıklayın ve kurs sahibinin kaldırılamayacağını önerin. Çoğu durumda, kullanıcı kendisini kaldırmaya çalışır ve buna izin verilmez.
CannotRemoveCourseOwnerTransferIncomplete
CannotRemoveCourseOwnerTransferIncomplete, bu sınıfın sahiplik aktarımı devam ettiğinden kurs sahibinin kaldırılamayacağını gösterir.
Olası işlem: Hatanın nedenini açıklayın ve kullanıcıya, sınıfın sahipliğini aktarma işleminin tamamlanması için birkaç dakika beklemesini ve ardından tekrar denemesini önerin.
CannotRemoveTeacherWithNoCourseOwner
CannotRemoveTeacherWithNoCourseOwner, öğretmenin sahibi olmayan bir dersten kaldırılamayacağını gösterir.
Olası işlem: Başarısızlığın nedenini açıklayın ve öğretmenin kaldırılamayacağını önerin. Çoğu durumda, kurs sahibinin kullanıcı hesabı silindiği için kurs durumu geçersiz olur.
InactiveCourseOwner
InactiveCourseOwner, kurs sahibinin hesabı silindiği için istenen işleme izin verilmediğini gösterir. İstenilen işlemi gerçekleştirmeden önce kurs sahibinin yöneticisinin, kurs sahibinin hesabını geri yüklemesi gerekir.
Olası işlem: Hatanın nedenini açıklayın ve yöneticinin işlemi yeniden denemeden önce kurs sahibinin hesabını geri yüklemesini önerin.
IneligibleOwner
IneligibleOwner, kullanıcının yardımcı öğretmen olmadığı için kursun sahibi olarak eklenemediğini gösterir.
Olası işlem: Hatanın nedenini açıklayın. İstekte bulunan kullanıcı yönetici değilse sahibi güncellemeden önce kullanıcıya kursta öğretmen olarak davetiye göndermesini önerin. İstekte bulunan kullanıcı bir yöneticiyse kullanıcıyı önce dersin yardımcı öğretmeni olarak eklemesini önerin.
UserCannotOwnCourse
UserCannotOwnCourse, kullanıcının kursun sahibi olarak eklenemeyeceğini gösterir.
Olası işlem: Hatanın nedenini açıklayın ve kursun, kullanıcının kurs sahibi olarak oluşturulamayacağını önerin. Yönetici olmayan bir kullanıcı, sahibi kendisi dışında bir kullanıcı olan bir kurs oluşturmaya çalışırken bu hatayı görebilir. Sahip olarak belirtilen kullanıcı hesabı mevcut değilse veya kullanıcı, alanına ait değilse kullanıcı isteğinde bulunan yönetici bu hatayı görebilir.
HTTP 429: RESOURCE_EXHAUSTED
Kota veya sunucu kapasitesi gibi bazı kaynaklar tükendiği için istenen işleme izin verilmediğinde RESOURCE_EXHAUSTED döndürülür. Bu tür istek hataları genellikle uygulamanızın aşırı yük oluşturduğundan kaynaklanır.
Bu sınırları tetiklememek ve uygulamanızın güvenilirliğini artırmak için yeniden deneme mekanizmalarını kullanın. Geçerli yeniden deneme mekanizmaları şunlardır:
İsteği yeniden denemek ve eşzamanlı ortamlarda isteklerin veri hızını en üst düzeye çıkarmak için kısaltılmış eksponansiyel geri yüklemeyi kullanın.
Çakışmaları önlemek için jitter ile kesikli eksponansiyel geri yükleme kullanabilirsiniz. Jitter eklemek, isteklerdeki ani artışları dağıtan rastgele bir gecikme ekleyerek isteklerinizin daha hızlı başarılı olmasına yardımcı olabilir.
Uygulamanız, kota sınırlamaları nedeniyle RESOURCE_EXHAUSTED hataları döndürüyorsa kota artırma isteği gönderin. Daha fazla bilgi için Monitor API kotaları yardım merkezi makalesine göz atın.
UserCourseJoinRateLimitReached
UserCourseJoinRateLimitReached, kullanıcının bir günde izin verilen maksimum sayıda derse katıldığını gösterir. Daha fazla bilgi için Gruplar politikalarını ve sınırlamalarını anlama başlıklı Yardım Merkezi makalesinin "Grup davetleri ve boyutu" bölümüne bakın.
Olası işlem: Hatanın nedenini açıklayın ve kullanıcının kursa katılmadan önce bir gün beklemesini önerin.
HTTP 500: INTERNAL
INTERNAL, istek işlenirken beklenmedik bir hata oluştuğunu gösterir. INTERNAL istek hataları, isteği yeniden denemek için üstel geri yükleme kullanılarak da çözülebilir. Devam eden INTERNAL hataları, Classroom API'nin herkese açık sorun izleyicisinde hata kaydı oluşturarak bildirilebilir.