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. Daha ayrıntılı olarak belirtmek gerekirse 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 oluşturma, değiştirme ve silme
  • CourseWork'e materyal (Drive dosyaları, YouTube videoları, bağlantılar) ekleme
  • Öğrencinin göndermesinin durumunu değiştirme (ör. teslim etme, iade etme, geri alma)
  • Ödev gönderimi için not ayarlama
  • Öğ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, ödevleri ve notları Classroom'dan kendi uygulamalarına 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, tüm ödev mutasyonu API isteklerinde, ödev oluşturulduğu sırada depolanan Google Cloud projesinin 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 birinin eklendiği ö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 izinlerine sahip değildir.

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 bir ödevin 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ı kaldırabilir.

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

Classroom paylaşım düğmesiyle zaten entegrasyon yaptım. 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'de 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?

Özel Google Cloud projelerini herkese açık projelere 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 eklentilerin tümü 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 projesindeki 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 sığmıyor. İç çerçeve 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ığı simge şekliyle eşleşecek şekilde yapıldı. Marka tutarlılığı için alanda aynı logonun kullanılmasına karar verdik.

Alanlar

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

Okul yöneticileri, yüklü bir eklentiyi hangi öğretmenlerin 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 (Yöneticiler), 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 bir eklenti izin verilenler listesi olduğunu unutmayın. Öğretmenler bu listedeki 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 sunabilirsiniz.

API

İş ortağı sayfasının bir iframe'de mi yoksa pop-up sekmesinde 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'i 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. Kimlikler bir e-posta adresiyle temsil edilir. Kimlik ve belirli bir Google Hizmeti'ne (Gmail dahil) erişim birbirinden farklıdır. Dolayısıyla, Gmail devre dışı olsa bile öğrenci kullanıcılar e-posta adresleriyle oturum açabilir.

Öğ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 sürüm notları sayfasında, geliştirici forumumuzda 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.