Eklerle etkileşimde bulunma

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ç noktası. İ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 ve dueTime.
  • 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:

  1. Öğrenci, bir etkinliği tamamlamak için studentViewUri uygulamasını başlatır.
  2. Eklenti, getAddOnContext yönteminden bir submissionId alır (öğrenci kimlik bilgilerini kullanarak).
  3. submissionId ve attachmentId, 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.
  4. Öğrenci çalışmalarını incelemek isteyen bir öğretmen studentWorkReviewUri İstek aşağıdaki sorgu parametrelerini içerir: courseId, itemId, itemType, attachmentId ve submissionId.
  5. 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 veya RECLAIMED_BY_STUDENT, öğrencinin düzenleme yapmasına izin verilebilir geri bildirim vermelidir. Ödev TURNED_IN veya RETURNED 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.