Bu sayfada, ek oluşturma ile ilgili uygulama ayrıntıları ve üzerinde uzlaşın. Şu bilgileri sağlamanız gerekebileceğini unutmayın: attachment ile ilgili parametreleri kullanın.
Ek oluştur
UygunCREATE
courses.*.addOnAttachments.create
uç nokta. İsteğinizde şunlar bulunmalıdır:
AddOnAttachment
örneği.
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 üzerindeki çalışmalarını görebileceği URI ekler. 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. Sıfır olmayan bir değer olmalıdır . Etkinlik türündeki ekler için geçerlidir gerekir.
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,
getAddOnContext
yönteminden birsubmissionId
alır (öğrenci kimlik bilgilerini kullanarak). submissionId
veattachmentId
, eklenti tarafından depolanır geliştiricisinin öğrenci çalışmasının benzersiz tanımlayıcısıdır. Karşı tarafın Classroom'da bir ödev kopyaladığında yeni bir eki görüntülemek için bu iki parametrenin birleşik anahtarını kullanır ödev kopyalandı. 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
İstek aşağıdaki 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. Tekliflerinizi otomatikleştirmek ve optimize etmek için
courses.courseWork.addOnAttachments.studentSubmissions
uç noktasını öğrenci gönderimleriyle ilgili bilgileri alma veya değiştirme.
Gönderim durumunu algıla
Şuna bir GET
isteği gönder:
Almak için courses.courseWork.addOnAttachments.studentSubmissions
uç noktası
belirli bir submissionId
hakkındaki ayrıntılar. Bir
Gönderimin notunu içeren AddOnAttachmentStudentSubmission
nesne
(pointsEarned
) ve mevcut durum (postSubmissionState
). Gönderim durumu
aşağıdaki değerlerden biri olabilir:
- Öğrenci gönderime hiç erişmediyse
NEW
. - Öğrenci bir gönderim oluşturduysa ancak henüz göndermediyse
CREATED
. - Öğrenci, çalışmasını öğretmene gönderdiyse
TURNED_IN
. - Öğretmen ödevi öğrenciye geri verdiyse
RETURNED
. - Öğrenci "gönderimi iptal etti" durumundaysa
RECLAIMED_BY_STUDENT
nasıl çalışmalarıdır?
Öğrencinin eklentinizde yaptığı çalışmanın durumunu algılamak için bu uç noktayı kullanın. Siz öğrenciye sunulan görünümleri veya seçenekleri durumu geri döndü. 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 bunu yanlışlıkla teslim edememesi anlamına gelir.
- Gönderimi düzenleme ayrıcalıkları kısıtlanıyor. Ödevin durumu varsa
CREATED
veyaRECLAIMED_BY_STUDENT
, öğrencinin düzenleme yapmasına izin verilebilir geri bildirim vermelidir. ÖdevTURNED_IN
veyaRETURNED
durumundaysa Öğrencinin gönderimini düzenleme izni olmayabilir.
Notlar ve birden çok ek
Tek bir eklentinin notunu belirlemek için yalnızca bir eklenti eki kullanılabilir
devredebilirsiniz. Bir öğretmen,
bir maxPoints
değeri sağlar. Yalnızca bu tür ilk ek
ödev notu. maxPoints
değerini ayarlanmadan bırakın veya sıfır olarak ayarlayın.
ve ek için notların sisteme geri gönderilmesi devre dışı bırakılır.
Gönderimin notunu belirleme
Şu öğrenciye PATCH
isteği göndererek bir öğrencinin gönderimini değiştirebilirsiniz:
courses.courseWork.addOnAttachments.studentSubmissions
uç noktası. İstek
gövde, aşağıdaki gibi bir AddOnAttachmentStudentSubmission
örneğini içermelidir:
değerleri değiştirebilirsiniz. Gönderimin notunu değiştirmek için pointsEarned
alanını ayarlayın.
pointsEarned
yılında iletilen değer, taslak not
öğretmeniyiz. Öğretmenler geçici notu değiştirebilir
teslim etmeden önce incelemeliyiz. Bkz.
Notların nasıl gösterildiğiyle ilgili ayrıntılar için Classroom kullanıcı arayüzü
ve öğretmenlere sunulur.
pointsEarned
ile not vermek için aşağıdaki koşulları karşılamanız gerekir
doğru:
- Ekin pozitif bir
maxPoints
değeri olmalıdır. - Eklentinin, eki asıl oluşturan kişi olması gerekir.
Önceden oluşturulmuş AddOnAttachment
öğesinin maxPoints
öğesini de değiştirebileceğinizi unutmayın
addOnAttachments
uç noktasına PATCH
isteği göndererek değer.
Ne zaman not vermelisiniz?
Notların Google Classroom'a ne zaman geri aktarılacağına ilişkin tercihte bulunabilirsiniz. İlgili içeriği oluşturmak için kullanılan en önemli ayrım, öğretmenin kimlik bilgilerini saklamayı bir notu yalnızca öğretmen değiştirebilir.
Notu geçirebileceğiniz iki eklenti anı vardır. Google Classroom: öğrenci çalışmasını tamamladığında veya öğretmen Öğrencinin çalışmasını Öğrenci Çalışması İncelemesi iframe'inde açar.
Öğrenci çalışmayı tamamladığında not vermek istiyorsanız bunun için öğretmenin çevrimdışı kimlik bilgilerini alabilir, ardından bu bilgileri alıp notu değiştirmek için kullanabilir öğrenci çalışmayı tamamladığında. Bu yöntem, potansiyel riskleri avantajları:
- Sorunsuz not güncellemeleri sağlayın. Öğretmenlerin özel bir notların Classroom kullanıcı arayüzünde doldurulmasını sağlar.
- Sınıfın ödevdeki ilerleme durumuyla ilgili gerçek zamanlı analiz sağlama. Notları öğrenciler ekleri tamamlarken öğretmenler bir fikir edinebilir öğrencilerinin daha iyi anlayacaksınız.
Bu yaklaşımın, notlandırma için eşzamansız bir yaklaşıma da olanak tanıdığını unutmayın.
senkronize edin. AddOnAttachmentStudentSubmission
için düzenli aralıklarla anket yapabilirsiniz.
uç noktamızı kullanır. Zaman
kayıtlı kimlik bilgilerini kullanarak ödevin notunu belirleyin.
Öğrenci oturumu sırasında öğretmenin kimlik bilgilerini yüklemek istemiyorsanız etkin öğretmenin kimlik bilgilerini kullanabilir, Öğrenci Çalışma İncelemesi iframe'inde gönderim. Ancak bu, özellikle de Classroom kullanıcı arayüzünde notlandırma sürecinde sorunsuz bir kullanıcı deneyimi gerçek zamanlı olarak güncellenmez ve öğretmenlerin her günü Öğrenci Çalışması İnceleme iframe'i.
Ödev notlarındaki değişiklikleri algılama
öğretmenlerin not ayarlarını Ödev oluşturulduktan sonra Classroom. Bu tür düzenlemeler şunlardır:
- 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 not verme ayarlarını görmek için
courses.courseWork
uç noktasına GET
isteği. Yanıt şunları içeriyor:
geçerli maxPoints
değerine ayarlayın. Not verilmemiş bir ödevde boş veya sıfır değeri var
maxPoints
değer.
Bir notu Classroom'a geri verdiyseniz
Getirilecek courses.courseWork.addOnAttachments.studentSubmissions
uç nokta veya
bir eklenti ekinin notunu değiştirme Not değeri
pointsEarned
alanı boş bırakılamaz. Bu değeri kontrol edebilir ve gerekirse güncelleyebilirsiniz.
Ürününüz öğretmenlerin belirli bir puan için öğrencinin puanını düzenlemesine izin veriyorsa
etkinliği'ne dokunun.