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?

Bitiş noktaları, geliştiricilerin sınıftaki çalışmaları görüntülemesine ve yönetmesine olanak tanır. Özellikle aşağıdakilerin tümünü yapabilirsiniz:

  • Bir kullanıcının ödevlerini ve sorularını (toplu olarak CourseWork olarak adlandırılır) görüntüleme.
  • CourseWork öğeleri oluşturma, değiştirme ve silme
  • CourseWork'e materyal (Drive dosyaları, YouTube videoları, bağlantılar) ekleyin.
  • Öğrencinin göndermesinin durumunu değiştirebilirsiniz (ör. teslim etme, iade etme, yeniden talep etme).
  • Ödev gönderimi için notu ayarlayın.
  • Öğrenci gönderimlerine materyal (Drive dosyaları, YouTube videoları, bağlantılar) ekleme

CourseWork için bazı örnek kullanım alanları:

  • Not defterleri, ÖBS'ler veya raporlama sistemleri, Classroom'daki ödevleri ve notları kendi uygulamalarıyla senkronize ederek manuel veri aktarımını ortadan kaldırabilir.
  • Öğrenim uygulamaları, sınıf akışında görünen yeni ödevler oluşturabilir. Öğrenciler çalışmalarını 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, eklentinizin eklerinin bulunduğu ödevlerini teslim edebilir.

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

Uygulamalar genellikle yalnızca kendi oluşturduğu çalışmaları değiştirebilir. Diğer bir deyişle, CourseWork'yi değiştirmek için yapılan API isteklerinde CourseWork'yi oluşturmak için kullanılan Google Cloud proje kimliği kullanılmalıdır.

Google Classroom eklentileri bu kuralın istisnası kapsamındadır. Cloud projeleri, eklentilerinden en az birine sahip olan duyurulara, ödevlere veya materyallere erişebilir ya da bu öğeleri değiştirebilir. Cloud projeleri, eklentilerinden en az birini içeren ödevleri de teslim edebilir, geri alabilir veya iade edebilir.

API isteklerinde doğru kullanıcı kapsamları da gereklidir. Öğ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'ü görüntüleyebilir ancak yazma izni 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ı henüz eklenemiyor.

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

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üğmesini zaten entegre ettim. Paylaşım düğmesi kullanılarak oluşturulan bir ödevi değiştirebilir miyim?

Henüz yok. Bir ödevi değiştirmek için istekte, ödevi oluşturan Google Cloud projesinin kullanılması gerekir.

API'deki soruları yanıtlayabilir miyim?

Henüz yok. Soru oluşturabilir ve mevcut 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ı projeye ihtiyacınız vardır.

Tek bir Google Cloud projesinin iki Google Workspace Marketplace girişi olabilir mi?

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

Ancak eklentileri paket halinde yayınlamak mümkündür. Bu sayede, tek bir Google Workspace Marketplace girişi birden fazla eklentiyi temsil edebilir. Bu tür bir girişten yükleme yaptığınızda paketteki tüm eklentiler tek seferde yüklenir. Kullanıcıların, yetki verirken paketlenmiş eklentilerin ihtiyaç duyduğu tüm kapsamlara izin vermesi gerekir.

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

Hayır, Classroom eklentisi Google Cloud projesi dışındaki bir Google Cloud projesinden OAuth istemcisi kullanılamaz. 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 sığmıyor. Classroom eklentileri iç çerçevesi başlık çubuğundaki logolar için hangi boyut seçenekleri var?

Iframe başlık çubuğu yalnızca 32x32 kare logoyu desteklemek için tasarlanmıştır. Bu seçim, şirketlerin web sitelerinde kullandıkları simge şekliyle eşleşecek şekilde yapıldı. Marka tutarlılığı için alanda aynı logonun kullanılmasına yönelik yönergemiz budur.

Alanlar

Aynı alandaki tüm öğretmen ve öğrencilerin, yüklü bir eklentiye erişimi var mı?

Alan yöneticileri, yüklü bir eklentiyi hangi öğretmenlerin görebileceğini kontrol edebilir. Classroom eklentileri yalnızca Teaching and 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önetici yükleme seçeneğini kullanarak bir eklentiyi alanın tamamına yükleyebilirler. Eklentiniz ayrı ayrı yüklenebilirse çoğu yöneticinin eklenti izin verilenler listesi olduğunu unutmayın. Bu listedeki öğretmenler eklentileri kendileri yükleyebilir. Yöneticiler, test amacıyla eklentinizi tek tek yüklemeyi de tercih edebilir.

Yöneticiler, eklentinizle ilgili kullanım istatistiklerini de inceleyebilir. Ürününüz tarafından destekleniyorsa kendi sitenizde yönetici görünümünde eklenti kullanım istatistikleri sunmayı düşünebilirsiniz.

API

Eklenti içeriğinin bir iframe'da mı yoksa yeni bir sekmede mi yüklendiğini öğrenmenin güvenilir bir yolu var mı?

Şu anda bu ikisini ayırt etmek için bir yöntem yoktur.

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

Öğrenci Çalışması İncelemesi iFrame'si yalnızca etkinlik türündeki ekler için sağlanır. Yayın 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 ekleri, eklendikleri yayın öğesine erişebilir mi?

Evet. Eklenti eklerinizden en az birini içeren Announcement, CourseWork veya CourseWorkMaterial dosyalarını get veya patch yapabilirsiniz. CourseWork StudentSubmission reclaim, return veya turnIn.

Tek Oturum Açma

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

Gmail erişimi olmasa bile her öğrencinin doğru biçimlendirilmiş bir e-posta adresi var mı?

Gmail'e erişip erişmediklerinden bağımsız olarak 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 Classroom'da e-posta adresleriyle oturum açabilir. Kimlikler, bir 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 saklarken birincil anahtar olarak kullanıcı kimliklerini kullanmanız önerilir.

Öğrencilerin oturum açmasına izin vermek için okul yöneticilerinin uygulamayı önceden onaylaması gerekir mi?

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

Geri bildirim ve genel sorular

Nasıl özellik isteğinde bulunabilirim veya sorun bildirebilirim?

Herkese açık sorun izleyicimizde özellik isteklerini gönderebilir, görüntüleyebilir ve bunlara oy verebilirsiniz.

Classroom API'de yeni özellikler ne zaman kullanıma sunulur?

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.