Sık Sorulan Sorular

Classroom'da CourseWork'ü görüntüleme, oluşturma ve değiştirme

Classroom API'deki CourseWork uç noktalarıyla ne geliştirebilirim?

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

  • Kullanıcıya ait ödev ve soruları (topluca "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
  • Bir öğrencinin gönderiminin durumunu değiştirme (teslim etme, geri verme, geri alma gibi)
  • Gönderilen ödevin notunu ayarlama
  • Öğrenci gönderimlerine materyal (Drive dosyaları, YouTube videoları, bağlantılar) ekleyin

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

  • Not defterleri, ÖBS veya raporlama sistemleri, Classroom'daki ödevleri ve notları uygulamalarına senkronize ederek manuel veri aktarımını ortadan kaldırabilir.
  • Öğrenim uygulamaları, sınıf akışında görünecek yeni ödevler oluşturabilir. Öğrenciler çalışmalarını tamamladıkça, uygulamalar çalışmaları teslim edebilir, not verebilir, öğrenci çalışmaları ekleyebilir ve çalışmaları uygun Drive klasörlerinde depolayabilir.
  • Öğretmen kullanıcılar, web sitenizden veya uygulamanızdan eklenti ekleri olan ö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 kendi oluşturduğu çalışmayı değiştirebilir. Başka bir deyişle, tüm atama değişikliği API'si istekleri, atama oluşturulurken depolanan Google Cloud projesinin kimliğini kullanmalıdır.

Google Classroom eklentilerinde bu kural için bir istisna bulunur. Bir Cloud projesi, bir veya daha fazla eklenti eki içeren tüm duyuru, ödev veya materyallere erişebilir ya da bunları değiştirebilir. Ayrıca Cloud projesi, bir veya daha fazla eklenti ekine sahip bir ödevi teslim edebilir, geri alabilir veya geri verebilir.

API istekleri doğru kullanıcı kapsamlarını da gerektirir. Öğretmenler ödevleri görüntüleyebilir, ödev oluşturabilir, gönderilen ödevlere bağlantı ekleyebilir ve gönderim notlarını belirleyebilir. Öğrenciler ödevleri görüntüleyebilir, ödev kayıtlarına bağlantı ekleyebilir ve ödevlerini teslim edip geri alabilir. Alan yöneticileri CourseWork'ü görüntüleyebilir ancak yazma izinlerine sahip değildir.

Başvurum, ödev veya gönderimlere ne tür öğeler ekleyebilir?

API; Drive dosyaları, YouTube videoları ve bağlantılar eklemeyi destekler. Yerel Google Formu ekleme henüz desteklenmiyor.

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

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

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

Classroom'daki paylaşım düğmesiyle zaten entegre oldum. Paylaş düğmesini kullanarak oluşturulan bir ödevde değişiklik yapabilir miyim?

Henüz değil. Bir atamayı değiştirmek için isteğin atamayı oluşturan Google Cloud projesini kullanması gerekir.

API'de soruları yanıtlayabilir miyim?

Henüz değil. Soru oluşturabilir ve mevcut soruları değiştirebilirsiniz. Soruları programatik olarak yanıtlamak yol haritamızdadır.

Classroom eklentileri

Proje yapılandırması

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

Gizli bir Google Cloud projesini herkese açık 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 GWM girişi olabilir mi?

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

Ancak eklentileri gruplandırmak mümkündür. Böylece tek bir GWM girişi birden fazla eklentiyi temsil edebilir. Böyle bir girişten yükleme yaptığınızda paketteki tüm eklentiler tek seferde yüklenir. Kullanıcıların yetkilendirme sırasında paket halinde sunulan eklentilerin ihtiyaç duyduğu tüm kapsamlara izin vermesi gerekir.

Gruplama ile ilgili dikkat edilmesi gereken iki nokta daha vardır:

  1. Classroom eklentileri yalnızca Teaching & Learning Upgrade veya Education Plus SKU aboneleri tarafından kullanılabilir.

  2. Eklentiler API'si Erken Erişim sürümündedir ve katılımcı geliştiriciler ve Google Cloud projeleriyle sınırlıdır. Paket olarak sunulan eklentiler, dahil olmayan Google Cloud projelerine dayanıyorlarsa beklendiği gibi çalışmayabilir.

Farklı bir Google Cloud projesine ait OAuth istemcisi, Classroom için Google Cloud projesi eklentileriyle tekrar kullanılabilir mi?

Hayır, Classroom eklentisi Google Cloud projesi dışındaki bir Google Cloud projesindeki OAuth istemcisi çalışmaz. 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ığmaz. iframe başlık çubuğundaki logolar için hangi boyut seçenekleri mevcut?

iframe başlık çubuğu, yalnızca 32x32 boyutundaki kare logoları destekleyecek şekilde tasarlanmıştır. Bu seçim, şirketlerin web sitelerinde kullandığı site simgesi şekline uyacak şekilde yapılmıştır ve marka tutarlılığı için alanda aynı logoyu kullanmamıza tavsiye ederiz.

Alan adları

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.

Alan yöneticileri eklentilerle nasıl etkileşimde bulunur?

Eklentinizi kimlerin kullanabileceğini alan yöneticileri (Yöneticiler) denetler. Yönetici yükleme seçeneğini kullanarak bir eklentiyi alanın tamamı için yükleyebilirler. Eklentiniz tek tek yüklenebiliyorsa çoğu yöneticinin bir eklenti izin verilenler listesi bulundurduğunu unutmayın. Öğretmenler bu listede bulunan eklentileri kendileri yükleyebilir. Bir yönetici, test amacıyla eklentinizi tek tek yüklemeyi de tercih edebilir.

Yöneticiler de eklentinizle ilgili kullanım istatistikleriyle ilgilenebilir. Ürününüz tarafından destekleniyorsa, eklenti kullanım istatistiklerini kendi sitenizde yönetici görünümünde sağlayabilirsiniz.

API

Aşağıdakilerden hangisi iş ortağı sayfasının bir iFrame veya açılır sekme içinde yüklendiğini anlamanın güvenilir bir yoludur?

Şu anda ikisi arasında ayrım yapmak için kullanılan bir yöntem yoktur.

Hangi ödev öğeleri Öğrenci Çalışması İncelemesi iframe'i alır?

Öğrenci Çalışması İnceleme 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.

Erken erişim programı sırasında API'de zarar veren değişiklikler olabilir mi?

Eklentiler API'si hâlâ geliştirme aşamasındadır. Bu nedenle, API'de yapılan bozulmalar daha önce başarılı olan isteklerin başarısız olmasına veya farklı davranmasına neden olabilir. Zarar veren değişiklikler olduğunda geliştirici forumu aracılığıyla önceden bildirimde bulunabilirsiniz.

Eklenti eki, bağlı olduğu akış öğesine erişebilir mi?

Evet. Eklenti eklerinizden en az birini içeren herhangi bir Announcement, CourseWork veya CourseWorkMaterial için get ya da patch. CourseWork StudentSubmission ile reclaim, return veya turnIn.

Classroom eklentileri ne zaman herkese açık olarak kullanıma sunulacak?

Classroom eklentileri, 2022 yazından itibaren tüm son kullanıcıların kullanımına sunulmuştur. Eklentiler API'sinin 2024'te geliştiricilerin kullanımına sunulması beklenmektedir.

Tek Oturum Açma

Evet, Google ile Oturum Açma özelliğini kullanmaya devam edebilirler.

Her öğrencinin Gmail erişimi olmasa bile doğru şekilde oluşturulmuş bir e-posta adresi var mı?

Her Google Workspace for Education kullanıcısı, Gmail'e erişimi olsa da olmasa da bir Google kimliğine sahiptir. Kimlikler e-posta adresiyle temsil edilir. Belirli Google Hizmetlerine (Gmail dahil) kimlik ve erişim birbirinden farklıdır. Böylece, 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öneticisinin uygulamayı önceden onaylaması gerekir mi?

Alan yöneticilerinin, eklentilerin yüklenebilmesi için izin verilenler listesine eklenmesi gerekir. İsteğe bağlı olarak, alan yöneticileri, alandaki veya bir kuruluş birimindeki tüm kullanıcılar için bir eklenti yükleyebilir.

Geri bildirim ve genel sorular

Özellik isteklerini nasıl gönderebilirim veya sorun talep etmek için ne yapabilirim?

Özellik isteklerini herkese açık sorun izleyicimizde gönderebilir, görüntüleyebilir ve oylayabilirsiniz.

Classroom API'deki yeni özelliklerin ne zaman kullanıma sunulacağını nasıl öğrenebilirim?

API güncellemeleri sürüm notları sayfasında, geliştirici forumumuzda ve herkese açık sorun izleyicide yayınlanmaktadır.

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

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