Sık Sorulan Sorular

Classroom'da sınıf çalışmalarını görüntüleme, oluşturma ve değiştirme

Classroom API'deki CourseWork uç noktalarıyla neler oluşturabilirim?

Uç noktalar, geliştiricilerin bir sınıftaki çalışmaları görüntülemesine ve yönetmesine olanak tanır. Tam olarak şunları yapabilirsiniz:

  • Bir kullanıcı için ödevleri ve soruları (topluca CourseWork olarak adlandırılır) görüntüleme.
  • CourseWork oluşturma, değiştirme ve silme
  • CourseWork'ya materyal (Drive dosyaları, YouTube videoları, bağlantılar) ekleyin.
  • Öğrenci gönderiminin durumunu değiştirme (ör. teslim etme, geri gönderme, geri alma).
  • Ödev gönderimi için not belirleme
  • Öğrenci gönderimlerine materyal (Drive dosyaları, YouTube videoları, bağlantılar) ekleme

CourseWork ile ilgili bazı örnek kullanım alanları:

  • Not defterleri, ÖBS veya raporlama sistemleri, ödevleri ve notları Classroom'dan uygulamalarına senkronize edebilir. Böylece manuel veri aktarımı ortadan kalkar.
  • Eğitim uygulamaları, sınıf akışında görünen yeni ödevler oluşturabilir. Öğrenciler çalışmaları tamamladıkça uygulamalar, çalışmaları teslim edebilir, not verebilir, öğrenci çalışmalarını ekleyebilir ve çalışmaları uygun Drive klasörlerinde saklayabilir.
  • Öğretmen kullanıcılar, web sitenizden veya uygulamanızdan eklenti ekleri içeren ödevler oluşturabilir.
  • Öğrenci kullanıcılar, eklenti eklerinizi içeren ödevlerini teslim edebilir.

Uygulamamın ödev oluşturmak veya değiştirmek için hangi izinlere ihtiyacı var?

Genellikle bir uygulama yalnızca oluşturduğu çalışmaları değiştirebilir. Başka bir deyişle, CourseWork öğesini değiştirmeye yönelik tüm API isteklerinde CourseWork öğesini oluşturmak için kullanılan Google Cloud projesi kimliği kullanılmalıdır.

Google Classroom eklentileri bu kuralın istisnasıdır. Bir Cloud projesi, eklenti eklerinden bir veya daha fazlasını içeren duyurulara, ödevlere ya da materyallere erişebilir veya bunları değiştirebilir. Ayrıca, bir Cloud projesi, eklenti ekleri olan bir ödevi gönderebilir, geri alabilir veya iade edebilir.

API istekleri için de doğru kullanıcı kapsamları gerekir. Öğretmenler ödevleri görüntüleyebilir, ödev oluşturabilir, ödev gönderimlerine bağlantı ekleyebilir ve gönderim notlarını ayarlayabilir. Öğrenciler ödevleri görüntüleyebilir, ödev kayıtlarına bağlantı ekleyebilir, gönderimlerini teslim edebilir ve geri alabilir. Alan adı yöneticileri CourseWork öğesini görüntüleyebilir ancak yazma izinleri yoktur.

Uygulamam, ödevlere veya gönderimlere ne tür öğeler ekleyebilir?

API, Drive dosyaları, YouTube videoları ve bağlantıların eklenmesini destekler. Yerel Google Formlar'ın eklenmesi henüz desteklenmemektedir.

Son kullanıcılar, Classroom'daki ödevlerin uygulamam tarafından oluşturulduğunu biliyor mu?

Evet. Classroom kullanıcı arayüzü, harici olarak oluşturulan ödevleri, çalışmayı oluşturan Google Cloud projesinin ürün adını kullanarak tanımlar. Kullanıcılar, harici olarak oluşturulan çalışmaları istenmeyen olarak bildirebilir ve kullanıcı tarafından uygulamaya verilen kimlik bilgilerini iptal ederek çalışmayı oluşturan uygulamanın bağlantısını kesebilir.

Classroom paylaşım düğmesi ve diğer entegrasyonlar

Classroom paylaşım düğmesiyle entegrasyonu zaten yaptım. Paylaş düğmesi kullanılarak oluşturulan bir ödevi değiştirebilir miyim?

Henüz yok. Bir ödevi değiştirmek için istek, ödevi oluşturan Google Cloud projesini kullanmalıdır.

API'de soruları yanıtlayabilir miyim?

Henüz yok. Soru oluşturabilir ve soruları değiştirebilirsiniz.

Classroom eklentileri

Proje yapılandırması

Geliştirme sırasında kullandığım özel bir Google Cloud projesini, üretimde kullanabileceğim herkese açık bir projeye dönüştürebilir miyim?

Hayır, gizli bir Google Cloud projesini herkese açık bir projeye dönüştüremezsiniz. Biri geliştirme, diğeri üretim için olmak üzere iki ayrı proje oluşturmanız gerekir.

Tek bir Google Cloud projesi iki Google Workspace Marketplace girişine sahip olabilir mi?

Hayır. Tek bir Google Cloud projesi için iki Google Workspace Marketplace girişi oluşturamazsınız.

Ancak eklentileri paketlemek mümkündür. Bu sayede, tek bir Google Workspace Marketplace listelemesi birden fazla eklentiyi temsil edebilir. Bu tür bir listelemeden yükleme yaptığınızda paketteki tüm eklentiler aynı anda yüklenir. Kullanıcıların, yetkilendirme sırasında paketlenmiş eklentilerin ihtiyaç duyduğu tüm kapsamları onaylaması gerekir.

Farklı bir Google Cloud projesindeki OAuth istemcisi, Classroom eklentileri için Google Cloud projesiyle yeniden kullanılabilir mi?

Hayır, Classroom eklentisi Google Cloud projesi dışındaki bir Google Cloud projesinden alınan OAuth istemcisi çalışamaz. Başka bir Google Cloud projesi tarafından oluşturulan erişim jetonları, Classroom API tarafından reddedilir. Eklenti projesi için ayrı bir OAuth istemcisi oluşturmanız gerekir.

Kullanıcı deneyimi

Logomuz küçük bir kareye iyi oturmuyor. Classroom eklentileri iç çerçeve başlık çubuğundaki logolar için hangi boyut seçenekleri var?

Iframe başlık çubuğu yalnızca 32x32 boyutunda kare logoyu destekleyecek şekilde tasarlanmıştır. Bu seçim, şirketlerin web sitelerinde kullandığı favicon şekliyle eşleşmesi için yapıldı. Marka tutarlılığı açısından bu alanda aynı logonun kullanılması önerilir.

Alanlar

Aynı alandaki tüm öğretmenler ve öğrenciler, yüklenen bir eklentiye erişebilir mi?

Alan yöneticileri, hangi öğretmenlerin yüklü bir eklentiyi görebileceğini kontrol edebilir. Classroom eklentileri yalnızca Teaching & Learning veya Education Plus lisansına sahip kullanıcılar tarafından kullanılabilir.

Alan yöneticileri eklentilerle nasıl etkileşim kurar?

Alan yöneticileri, eklentinizi kimlerin kullanabileceğini kontrol eder. Yöneticiler, yükleme seçeneğini kullanarak bir eklentiyi alanın tamamına yükleyebilir. Eklentiniz ayrı ayrı yüklenebiliyorsa çoğu yöneticinin bir eklenti izin verilenler listesi tuttuğunu unutmayın. Bu listedeki öğretmenler eklentileri kendileri için yükleyebilir. Yöneticiler, test amacıyla eklentinizi tek tek de yükleyebilir.

Yöneticiler, eklentinizle ilgili kullanım istatistikleriyle de ilgilenebilir. Ürününüz destekliyorsa kendi sitenizdeki bir yönetici görünümünde eklenti kullanım istatistikleri sağlamayı düşünebilirsiniz.

API

Eklenti içeriğinin bir iFrame'e mi yoksa yeni bir sekmeye mi yüklendiğini öğrenmenin güvenilir yolu nedir?

İkisi arasında ayrım yapmanın şu anda bir yöntemi yoktur.

Hangi atanabilir çalışma öğelerine öğrenci çalışması inceleme iFrame'i eklenir?

Öğrenci Çalışması İnceleme iFrame'i yalnızca etkinlik türü ekler için sağlanır. Gönderi türünün öğrenci çalışmalarını destekleyip desteklemediğini öğrenmek için courses.courseWork.getAddOnContext yöntemini çağırın. supportsStudentWork alanı yalnızca etkinlik olan bir yayın türü için true olabilir.

Eklenti eki, eklendiği yayın öğesine erişebilir mi?

Evet. Eklenti eklerinizden en az birini içeren tüm Announcement, CourseWork veya CourseWorkMaterial öğelerini get ya da patch yapabilirsiniz. CourseWork StudentSubmission için reclaim, return veya turnIn işlemlerini yapabilirsiniz.

Tek Oturum Açma

Evet, Google ile oturum açma özelliğini kullanmaya devam edebilirler.

Gmail erişimi olmasa bile her öğrencinin düzgün şekilde oluşturulmuş bir e-posta adresi var mı?

Gmail'e erişimleri olup olmadığına bakılmaksızın her Google Workspace for Education kullanıcısının bir Google kimliği vardır. Kimlik ve belirli bir Google Hizmeti'ne (Gmail dahil) erişim birbirinden farklıdır. Gmail devre dışı olsa bile öğrenci kullanıcılar e-posta adresleriyle Classroom'da oturum açabilir. Kimlikler, kullanıcı kimliği ve e-posta adresiyle temsil edilir. Google Workspace for Education kullanıcıları e-posta adreslerini değiştirebilir. Bu nedenle, kullanıcı bilgilerini depolarken birincil anahtar olarak kullanıcı kimliklerini kullanmanız önerilir.

Öğrencilerin oturum açabilmesi için okul yöneticisinin uygulamayı önceden onaylaması gerekir mi?

Alan yöneticilerinin, eklentilerin yüklenebilmesi için izin verilenler listesine eklemesi gerekir. Dilerseniz alan yöneticileri, alan veya kuruluş birimi içindeki tüm kullanıcılar için bir eklenti yükleyebilir.

Geri bildirim ve genel sorular

Nasıl özellik isteğinde bulunabilir veya sorun isteği gönderebilirim?

Özellik isteklerini genel sorun izleyicimize gönderebilir, görüntüleyebilir ve bu istekler için oy kullanabilirsiniz.

Classroom API'de yeni özelliklerin kullanıma sunulduğunu nasıl öğrenebilirim?

API'deki güncellemeler geliştirici bülteninde ve herkese açık sorun izleyicide yayınlanır.

Classroom API'yi kullanıyorum. Teknik soruları nasıl sorabilirim?

Sorularınızı Stack Overflow'da google-classroom etiketiyle yayınlayın.