Request Errors

İstek Hataları

Classroom API hataları, sorunun 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 işlemleri yapmaya yönlendirebilirsiniz.

Bu sayfada, olası hata kodları HTTP koduna göre gruplandırılmış halde ayrıntılı olarak açıklanmaktadır. Hata mesajı yapısı hakkında daha fazla bilgi edinmek için Hata Mesajı Yapısı bölümüne bakın.

Bu sayfada, olası hata kodları HTTP koduna göre gruplandırılmış halde ayrıntılı olarak açıklanmaktadır. Hangi yöntemlerin belirli bir hata kodu döndürdüğünü belirlemek için referans belgelerine bakın.

HTTP 400: FAILED_PRECONDITION

Kullanıcı, bir sınıra veya uygulama durumuna (ör. CourseNotModifiable) ulaştığı için izin verilemeyen bir işlem denediğinde FAILED_PRECONDITION döndürülür. FAILED_PRECONDITION sorununu düzeltmek için kullanıcıdan işlem yapmasını ve ardından yeniden denemesini isteyin. Alternatif olarak, bazı durumlarda kullanıcı adına durumu düzeltmek için alternatif uç noktalar kullanabilirsiniz.

PendingInvitationExists

PendingInvitationExists bir kullanıcının zaten dersin sahipliğini almak için davet edildiğini gösterir. Bu hata, daha önce başlatılmış ancak yeni sahip tarafından henüz kabul edilmemiş bir aktarım sırasında ders sahipliği aktarımı sırasında ortaya çıkar.

CourseMemberLimitReached

CourseMemberLimitReached, yapılmaya çalışılan işlemin izin verilen maksimum ders üyesi sayısını aşacağını belirtir. 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ıftaki kişi sayısı sınırları" bölümüne bakın.

Olası İşlem: Hatanın nedenini açıklayın ve kullanıcıya gereksiz ders üyelerini kaldırmasını önerin

CourseNotModifiable

CourseNotModifiable ilgili kursun, özelliklerinin değiştirilmesine izin vermeyen bir durumda olduğunu belirtir (ders durumunun kendisi dışında).

Olası İşlem: Kullanıcıdan kursu değiştirilebilir kurs durumuna geçirmesini isteyin. Durumu değiştirmek için courses.patch() işlevini kullanın. Kurs durumu, diğer özellikleri değiştiren bir istekte değiştirilebilir.

CourseTeacherLimitReached

CourseTeacherLimitReached, istenen işlemin izin verilen maksimum ders öğretmeni sayısını aşacağını belirtir. Bu kod genellikle teachers.create() tarafından döndürülür. Daha fazla bilgi edinmek için Sınıfa yardımcı öğretmen ekleme başlıklı yardım merkezi makalesinin "Sınıftaki kişi sayısı sınırlamaları" bölümüne bakın.

Olası İşlem: Hatanın nedenini açıklayın ve kullanıcıya gereksiz ders öğretmenlerini kaldırmasını önerin. Uygulamanız için geçerliyse öğretmen listelerini kullanıcı adına yönetmek için teachers.delete() kullanabilirsiniz.

UserGroupsMembershipLimitReached

UserGroupsMembershipLimitReached, kullanıcının zaten izin verilen maksimum sayıda grubun üyesi olduğunu ve hiçbir derse katılamayacağını belirtir. 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 başlıklı yardım merkezi makalesinin "Sınıftaki kişi sayısı sınırlamaları" bölümüne bakın.

Olası İşlem: Hatanın nedenini açıklayın ve kullanıcıya katılmadığı derslerden ayrılmasını önerin. Daha fazla kursa katılması gerekiyorsa kullanıcı ek bir hesap oluşturabilir. Uygulamanız için geçerliyse öğrenci listelerini kullanıcı adına yönetmek için students.create() veya teachers.delete() aracını kullanabilirsiniz.

AttachmentNotVisible

AttachmentNotVisible belirtilen bir veya daha fazla ekin kullanıcı tarafından görülemediğini, istenen türde olmadığını ya da mevcut olmadığını belirtir. Örneğin, kullanıcıyla paylaşılmayan Drive öğeleri bu hatayı döndürür.

Olası İşlem: Hatanın nedenini açıklayın ve kullanıcıya, eklediği Drive dosya kimlikleri gibi tanımlayıcıları 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, Drive klasörünün sahibinin kaldırılamayacağını belirtir.

Olası İşlem: Hatanın nedenini açıklayın ve kullanıcıya ders Drive klasörünün sahipliğini farklı bir kullanıcıya aktarmasını ve tekrar denemesini önerin.

CannotRemoveCourseOwner

CannotRemoveCourseOwner, ders sahibinin kaldırılmayabileceğini belirtir.

Olası İşlem: Hatanın nedenini açıklayın ve ders sahibinin kaldırılmama ihtimalini önerin. Çoğu durumda kullanıcı kendini kaldırmaya çalışır. Bu duruma izin verilmez.

CannotRemoveCourseOwnerTransferIncomplete

CannotRemoveCourseOwnerTransferIncomplete, bu sınıfın sahiplik aktarımı devam ettiğinden ders sahibinin kaldırılmayabileceğini belirtir.

Olası İşlem: Hatanın nedenini açıklayın ve kullanıcıya, sınıfın sahipliğini aktarma eşzamansız işleminin tamamlanması için birkaç dakika beklemesini ve ardından tekrar denemesini önerin.

CannotRemoveTeacherWithNoCourseOwner

CannotRemoveTeacherWithNoCourseOwner, öğretmenin sahibi olmayan derslerden çıkarılamayacağını belirtir.

Olası İşlem: Hatanın nedenini açıklayın ve öğretmenin çıkarılmayabileceğini önerin. Çoğu durumda, ders sahibinin kullanıcı hesabı silinerek geçersiz ders durumuna neden olur.

InactiveCourseOwner

InactiveCourseOwner, ders sahibinin hesabı silindiğinden istenen işleme izin verilmediğini gösteriyor. İstenen işlemi yapmadan önce ders sahibinin yöneticisinin, ders sahibinin hesabını geri yüklemesi gerekir.

Olası İşlem: Hatanın nedenini açıklayın ve yöneticiye, işlemi yeniden denemeden önce ders sahibinin hesabını geri yüklemesini önerin.

IneligibleOwner

IneligibleOwner, kullanıcı yardımcı öğretmen olmadığından kullanıcının dersin sahibi olarak eklenemediğini belirtir.

Olası İşlem: Hatanın nedenini açıklayın. İstekte bulunan kullanıcı yönetici değilse, giriş sahibini güncellemeden önce kullanıcıya derste öğretmen olması için davetiye göndermesini önerin. İstekte bulunan kullanıcı bir yöneticiyse, önce kullanıcıyı dersin yardımcı öğretmeni olarak eklemesini önerin.

UserCannotOwnCourse

UserCannotOwnCourse, kullanıcının dersin sahibi olarak eklenemeyeceğini belirtir.

Olası İşlem: Hatanın nedenini açıklayın ve sahibin kullanıcı olduğu bir dersin oluşturulamayacağını önerin. Yönetici olmayan bir kullanıcı, kendisinden farklı bir kullanıcıyla ders oluşturmayı denediğinde bu hatayla karşılaşabilir. Sahip olarak belirtilen kullanıcı hesabı yoksa veya kullanıcı kendi alanında yer almıyorsa kullanıcı isteğinde bulunan bir 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 aşırı yük oluşturduğundan meydana gelir.

Bu sınırları tetiklemekten kaçınmak 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 işleme hızını en üst düzeye çıkarmak için kısaltılmış üstel geri yüklemeyi kullanın.

  • Çarpışmaları önlemek için ses dalgalanması nedeniyle kısaltılmış üstel geri çekilme seçeneğini değerlendirin. Ses dalgalanması eklemek, isteklerdeki ani artışları yayan rastgele bir gecikme uygulayarak isteklerinizin daha hızlı başarılı olmasına yardımcı olabilir.

Uygulamanız kota sınırlamaları nedeniyle RESOURCE_EXHAUSTED hata döndürürse kota artışı gönderin. Daha fazla bilgi için API kotalarını izleme başlıklı yardım merkezi makalesini inceleyin.

UserCourseJoinRateLimitReached

UserCourseJoinRateLimitReached, kullanıcının bir gün içinde izin verilen maksimum ders sayısına zaten katıldığını gösterir. Daha fazla bilgi edinmek için Grup politikalarını ve sınırlamalarını anlama başlıklı yardım merkezi makalesinin "Grup davetiyeleri ve boyut" bölümüne bakın.

Olası İşlem: Hatanın nedenini açıklayın ve kullanıcıya derse katılmadan önce bir gün beklemesini önerin.

HTTP 500: INTERNAL

INTERNAL, istek işlenirken beklenmeyen bir hata oluştuğunu belirtir. INTERNAL istek hataları, genellikle isteği yeniden denemek için üstel geri yükleme kullanılarak da çözülebilir. Bir INTERNAL hatası devam ederse Classroom API herkese açık sorun izleyicide bir hata bildiriminde bulunarak sorunu bildirebilirsiniz.