Eklerle etkileşimde bulunma

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 ve dueTime.
  • 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:

  1. Öğrenci, bir etkinliği tamamlamak için studentViewUri uygulamasını başlatır.
  2. Eklenti, öğrenci kimlik bilgilerini kullanarak getAddOnContext yönteminden bir submissionId alır.
  3. submissionId ve attachmentId, öğ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.
  4. Öğrenci çalışmalarını incelemek isteyen bir öğretmen studentWorkReviewUri uygulamasını kullanıma sunar. İstek şu 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. Öğ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 veya RECLAIMED_BY_STUDENT durumundaysa öğrencinin gönderimini düzenlemesine izin verilebilir. Ödev TURNED_IN veya RETURNED 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.