Bu sayfada, ek oluşturmak ve öğrenci gönderimleriyle çalışmak için uygulama ayrıntıları açıklanmaktadır. Bu istekleri yaparken ekle ilgili parametreler sağlamanız gerekebileceğini unutmayın.
Ek oluştur
Uygun courses.*.addOnAttachments.create
uç noktasına CREATE
isteği göndererek ek oluşturun. İsteğinizin, istek gövdesinde AddOnAttachment
öğesinin bir örneğini içermesi gerekir.
Ek oluştururken aşağıdaki alanlar gereklidir:
title
: Ekin dize adı.teacherViewUri
: ekin Öğretmen Görünümü için URI.studentViewUri
: Ekin Öğrenci Görünümü için URI.studentWorkReviewUri
: öğretmenin, öğrencinin ek üzerindeki çalışmasını görebileceği URI. Bu alan yalnızca etkinlik türündeki ekler için gereklidir.
Aşağıdaki isteğe bağlı alanlardan bazılarını ekleyebilirsiniz:
- Ekin teslim tarihini belirtiyorsanız
dueDate
vedueTime
. maxPoints
: Ek için maksimum not. Notların sisteme geri gönderilmesini desteklemek istiyorsanız sıfır olmayan bir değer olmalıdır. Yalnızca etkinlik türündeki ekler için geçerlidir.
Bu alanlarla ilgili daha fazla bilgi için AddOnAttachment
kaynak referansına bakın.
Öğrencinin gönderim ayrıntıları
Genel bir gönderim iş akışında aşağıdaki adımlar izlenir:
- Öğrenci, bir etkinliği tamamlamak için
studentViewUri
uygulamasını başlatır. - Eklenti, öğrenci kimlik bilgilerini kullanarak
getAddOnContext
yönteminden birsubmissionId
alır. submissionId
veattachmentId
, öğrencinin çalışmasının benzersiz tanımlayıcısı olarak eklenti geliştiricisi tarafından depolanır. Öğretmenin Classroom'da bir ödevi kopyalaması durumunda, bu iki parametrenin birleşik anahtarını kullanarak, kopyalanan ödevde yeni bir ek görüntüleyebilirsiniz. Daha fazla bilgi edinmek için kopyalanan içerik ile ilgili sayfamıza göz atın.- Öğrenci çalışmalarını incelemek isteyen bir öğretmen
studentWorkReviewUri
uygulamasını kullanıma sunar. İstek şu sorgu parametrelerini içerir:courseId
,itemId
,itemType
,attachmentId
vesubmissionId
. - Eklenti geliştiricisi, öğrenci çalışmalarını almak için bu dört kimliği kullanır. Öğrenci gönderimiyle ilgili bilgileri almak veya değiştirmek için
courses.courseWork.addOnAttachments.studentSubmissions
uç noktasını kullanın.
Gönderim durumunu algıla
Belirli bir submissionId
ile ilgili ayrıntıları almak için courses.courseWork.addOnAttachments.studentSubmissions
uç noktasına bir GET
isteği gönderin. Gönderimin notunu (pointsEarned
) ve mevcut durumunu (postSubmissionState
) içeren bir AddOnAttachmentStudentSubmission
nesnesi alırsınız. Gönderim durumu, aşağıdaki değerlerden biri olabilir:
- Öğrenci gönderime hiç erişmediyse
NEW
. CREATED
, öğrenci bir gönderim oluşturduysa ancak henüz göndermediyse.- Öğrenci, çalışmasını öğretmene gönderdiyse
TURNED_IN
. - Öğretmen ödevi öğrenciye geri verdiyse
RETURNED
. - Öğrenci, çalışmasını "göndermeyi iptal ettiyse"
RECLAIMED_BY_STUDENT
.
Öğrencinin eklentinizde yaptığı çalışmanın durumunu algılamak için bu uç noktayı kullanın. Daha sonra, döndürülen duruma göre öğrenciye sunulan görünümleri veya seçenekleri ayarlayabilirsiniz. Bu, aşağıdaki gibi özellikleri içerebilir:
- Eklentinizdeki ödevlerin teslim durumunu görüntüleme. Bu, öğrencilerin olası karışıklıklardan kaçınmasına yardımcı olur ve ödevi yanlışlıkla teslim etmemelerini sağlar.
- Gönderimi düzenleme ayrıcalıkları kısıtlanıyor. Ödev
CREATED
veyaRECLAIMED_BY_STUDENT
durumundaysa öğrencinin gönderimini düzenlemesine izin verilebilir. ÖdevTURNED_IN
veyaRETURNED
durumuna sahipse öğrencinin gönderimini düzenlemesine izin verilmeyebilir.
Notlar ve birden çok ek
Tek bir ödevin notunu ayarlamak için yalnızca bir eklenti eki kullanılabilir. Bir öğretmen, maxPoints
değeri sağlayan birden fazla etkinlik türü eki oluşturursa ödev notunu yalnızca bu tür ilk ek belirleyebilir. maxPoints
değerini ayarlamadan bırakın veya sıfır olarak ayarlayarak ek için not geri gönderme özelliğini devre dışı bırakın.
Gönderimin notunu belirleme
courses.courseWork.addOnAttachments.studentSubmissions
uç noktasına PATCH
isteği göndererek öğrenci gönderimini değiştirebilirsiniz. İstek gövdesi, değiştirilmiş değerlere sahip bir AddOnAttachmentStudentSubmission
örneği içermelidir. Gönderimin notunu değiştirmek için pointsEarned
alanını ayarlayın.
pointsEarned
aracında iletilen değer, Classroom kullanıcı arayüzünde öğretmen tarafından görülebilecek bir taslak not hâline gelir. Öğretmenler, ödevi öğrencilere geri vermeden
önce geçici notu değiştirebilir. Öğretmenlere notların nasıl sunulduğuyla ilgili ayrıntılar için Classroom kullanıcı arayüzünde not vermeye genel bakış başlıklı makaleyi inceleyin.
Yalnızca aşağıdakiler doğruysa pointsEarned
ile not ayarlayabileceğinizi unutmayın:
- Ekin pozitif bir
maxPoints
değeri olmalıdır. - Eklentinin, eki asıl oluşturan kişi olması gerekir.
Ayrıca, addOnAttachments
uç noktasına bir PATCH
isteği göndererek önceden oluşturulmuş bir AddOnAttachment
öğesinin maxPoints
değerini değiştirebilirsiniz.
Ne zaman not vermelisiniz?
Notların Google Classroom'a ne zaman geri aktarılacağına ilişkin tercihte bulunabilirsiniz. Bir notu yalnızca öğretmen değiştirebilir. Bu nedenle önemli ayrım, öğretmenin kimlik bilgilerini saklamayı seçip seçmemenizdir.
Google Classroom'a not verebileceğiniz iki eklenti anı vardır: öğrenci çalışmasını tamamladığında veya öğretmenin Öğrenci Çalışması İncelemesi iframe'inde çalışmasını açtığında.
Öğrenci ödevi tamamladığında notları belirlemek istiyorsanız öğretmenlerin çevrimdışı kimlik bilgilerini saklamanız, ardından öğrenci ödevi tamamladığında notu değiştirmek için bu kimlik bilgilerini almanız ve kullanmanız gerekir. Bu yöntemin bazı potansiyel faydaları vardır:
- Sorunsuz not güncellemeleri sağlayın. Notların Classroom kullanıcı arayüzünde doldurulması için öğretmenlerin herhangi bir özel işlem yapması gerekmez.
- Sınıfın ödevdeki ilerleme durumuyla ilgili gerçek zamanlı analiz sağlama. Öğretmenler, ekler tamamladıkça verilen notları göstererek, her ödevi açmadan öğrencilerinin anlayışını anlayabilir.
Bu yaklaşımın, not senkronizasyonu için eşzamansız yaklaşıma da olanak tanıdığını unutmayın. Bir öğrencinin çalışmasını ne zaman gönderdiğini tespit etmek için AddOnAttachmentStudentSubmission
uç noktasını düzenli olarak yoklayabilirsiniz. Gönderildikten sonra, kayıtlı kimlik bilgilerini kullanarak gönderimin notunu ayarlayın.
Bir öğrenci oturumu sırasında öğretmenin kimlik bilgilerini yüklemek istemiyorsanız öğrencinin ödevini Öğrenci Çalışma İncelemesi iframe'inde yüklediğinde etkin öğretmenin kimlik bilgilerini kullanabilirsiniz. Ancak, Classroom kullanıcı arayüzündeki notlar gerçek zamanlı olarak güncellenmediği ve öğretmenlerin her gönderime ait Öğrenci Çalışması Yorumu iframe'ini açmaları gerekeceğinden, bu kullanım oldukça sorunsuz bir kullanıcı deneyimi sunmayabilir.
Ödev notlarındaki değişiklikleri algılama
Öğretmenler, ödev oluşturulduktan sonra Classroom'daki not ayarlarını düzenleyebilir. Bu tür düzenlemeler şunları içerebilir:
- Atanan puan değerini değiştirme.
- Bir ödevin
maxPoints
değerini değiştirme. - Ödeve not verilip verilmeyeceğini değiştirme.
Bir ödevin mevcut notlandırma ayarlarını görmek için courses.courseWork
uç noktasına bir GET
isteği göndermenizi öneririz. Yanıt, mevcut maxPoints
değerini içerir. Notlandırılmamış ödevlerde null veya sıfır maxPoints
değeri var.
Classroom'a tekrar not verdiyseniz eklenti ekinin notunu getirmek veya değiştirmek için courses.courseWork.addOnAttachments.studentSubmissions
uç noktasını kullanın. Not değeri, pointsEarned
alanı kullanılarak ayarlanır. Ürününüz öğretmenlerin belirli bir etkinlik için öğrencinin puanını düzenlemesine izin veriyorsa bu değeri kontrol edebilir ve gerekirse güncelleyebilirsiniz.