Bu sayfa, Cloud Translation API ile çevrilmiştir.

Eklerle etkileşimde bulunma

Bu sayfada, ek oluşturma ve öğrenci gönderimleriyle çalışmayla ilgili uygulama ayrıntıları başlıklı makalede açıklanmıştır. Bu istekleri yaparken ekle ilgili parametreleri sağlamanız gerekebileceğini unutmayın.

Ek oluşturun

Uygun courses.*.addOnAttachments.create uç noktasına CREATE isteği göndererek bir ek oluşturun. İsteğinizin, istek gövdesinde bir AddOnAttachment örneği içermesi gerekir.

Ek oluştururken aşağıdaki alanlar gereklidir:

title: Ekin dize adı.
teacherViewUri: Ekin Öğretmen Görünümüne ait URI.
studentViewUri: Ekin Öğrenci Görünümüne ait URI.
studentWorkReviewUri: Öğrencinin ek üzerindeki çalışmasını görmek için öğretmene yönelik URI. Bu alan yalnızca etkinlik türü ekler için gereklidir.

Aşağıdaki isteğe bağlı alanlardan bazılarını dahil etmek isteyebilirsiniz:

Ekin ne zaman teslim edilmesi gerektiğini belirtiyorsanız dueDate ve dueTime.
maxPoints: Ek için maksimum not. Notların geri verilmesini desteklemek istiyorsanız sıfır dışında bir değer olmalıdır. Yalnızca etkinlik türündeki ekler için geçerlidir.

Bu alanlarla ilgili daha ayrıntılı bilgi için AddOnAttachment kaynak referansına bakın.

Öğrencinin gönderim bilgileri

Tipik bir gönderim iş akışında şu adımlar uygulanır:

Öğrenci, bir etkinliği tamamlamak için studentViewUri uygulamasını başlatır.
Eklenti, öğrenci kimlik bilgilerini kullanarak getAddOnContext yönteminden bir submissionId alır.
Eklenti geliştiricisi submissionId ve attachmentId, öğrencinin çalışmasının benzersiz tanımlayıcısı olarak depolanır. Öğretmenin Classroom'da bir ödevi kopyalaması durumunda, kopyalanan ödevde yeni bir ek görüntülemek için bu iki parametrenin birleşik anahtarını kullanabilirsiniz. Daha fazla ayrıntı için kopyalanan içerik sayfamıza bakın.
Öğrenci çalışmalarını incelemek isteyen bir öğretmen, studentWorkReviewUri uygulamasını başlatır. İstek şu sorgu parametrelerini içerir: courseId, itemId, itemType, attachmentId ve submissionId.
Eklenti geliştiricisi, öğrenci çalışmalarını almak için bu dört kimliği kullanır. Öğrenci gönderimleriyle 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 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 daha önce hiç erişmediyse NEW.
Öğrenci bir gönderim oluşturduysa ancak henüz göndermediyse CREATED.
Öğrenci, çalışmasını öğretmene teslim ettiyse TURNED_IN.
Öğretmen gönderimi öğrenciye geri verdiyse RETURNED.
Öğrenci çalışmasının "gönderimini iptal ettiyse" RECLAIMED_BY_STUDENT.

Eklentinizde öğrencinin çalışmasının durumunu algılamak için bu uç noktayı kullanın. Ardından, döndürülen eyalete bağlı olarak öğrenciye sunulan görünümleri veya seçenekleri ayarlayabilirsiniz. Bu, aşağıdaki özellikleri içerebilir:

Eklentinizde ödevlerin teslim durumunu gösterme. Bu sayede öğrenciler olası karışıklıkların önüne geçebilir ve ödevini yanlışlıkla teslim etmeyebilir.
Gönderim düzenleme ayrıcalıkları kısıtlanıyor. Ödevin durumu CREATED veya RECLAIMED_BY_STUDENT ise öğrencinin gönderimini düzenlemesine izin verilebilir. Ödevin durumu TURNED_IN veya RETURNED ise öğrencinin gönderimini düzenlemesine izin verilmeyebilir.

Notlar ve birden fazla 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ünde ek oluşturursa ödev notunu yalnızca bu tür ilk ek ayarlayabilir. Ekte notların geri verilmesini devre dışı bırakmak için maxPoints değerini ayarlamadan bırakın veya sıfır olarak ayarlayın.

Gönderimin notunu ayarlama

Öğrencilerin gönderimini değiştirmek için courses.courseWork.addOnAttachments.studentSubmissions uç noktasına PATCH isteği gönderebilirsiniz. İstek gövdesi, değiştirilmiş değerlerle AddOnAttachmentStudentSubmission öğesinin bir örneğini içermelidir. Bir gönderimin notunu değiştirmek için pointsEarned alanını ayarlayın. pointsEarned için iletilen değer, Classroom kullanıcı arayüzünde öğretmen tarafından görülebilecek bir taslak not haline gelir. Öğretmenler, ödevi öğrencilere geri vermeden önce taslak notta değişiklik yapabilir. Notların öğretmenlere nasıl gösterildiğiyle ilgili ayrıntılar için Classroom kullanıcı arayüzünde not vermeye genel bakış başlıklı makaleye göz atın.

Yalnızca aşağıdaki koşullar geçerliyse pointsEarned ile not ayarlayabileceğinizi unutmayın:

Ekin pozitif bir maxPoints değeri olmalıdır.
Eklenti, ekin orijinal oluşturucusu olmalıdır.

Ayrıca, addOnAttachments uç noktasına bir PATCH isteği göndererek önceden oluşturulmuş bir AddOnAttachment maxPoints değerini değiştirebileceğinizi de unutmayın.

Not ne zaman belirlenmelidir?

Google Classroom'a notun ne zaman geri verileceği konusunda seçim yapabilirsiniz. Notları yalnızca öğretmen değiştirebilir. Bu nedenle, burada en önemli fark öğretmenin kimlik bilgilerinin saklanıp saklanmamasıdır.

Google Classroom'a not verebileceğiniz iki eklenti anları vardır: öğrencinin çalışmasını tamamladığında veya öğretmen öğrencinin çalışmasını Öğrenci Çalışması İncelemesi iframe'de açtığında.

Öğrenci çalışmayı tamamladığında notları ayarlamak istiyorsanız öğretmenin çevrimdışı kimlik bilgilerini depolamanız ve ardından bunları alıp öğrenci çalışmayı tamamladığında aldığınız notu değiştirmek için kullanmanız gerekir. Bu yöntemin bazı potansiyel avantajları vardır:

Sorunsuz not güncellemeleri sağlayın. Öğretmenlerin, notların Classroom kullanıcı arayüzünde doldurulmasını sağlamak için özel bir işlem yapmasına gerek yoktur.
Sınıfın bir ödevdeki ilerlemesi hakkında gerçek zamanlı analiz sağlar. Öğretmenler, ekleri tamamlarken notları ayarlayarak her gönderimi açmadan öğrencilerinin düşüncelerini anlayabilir.

Bu yaklaşımın, senkronizasyona not vermek için eşzamansız bir yaklaşıma da izin verdiğini unutmayın. Bir öğrencinin çalışmasını ne zaman gönderdiğini tespit etmek için AddOnAttachmentStudentSubmission uç noktasını düzenli aralıklarla anket yapabilirsiniz. Ödev gönderildiğinde, depolanan kimlik bilgilerini kullanarak gönderimin notunu ayarlayın.

Öğrenci oturumu sırasında öğretmenin kimlik bilgilerini yüklemek istemiyorsanız Öğrenci Çalışması İncelemesi iframe'de öğrencinin gönderimini yüklerken etkin öğretmenin kimlik bilgilerini kullanabilirsiniz. Ancak, Classroom kullanıcı arayüzündeki notlar gerçek zamanlı olarak güncellenmediği ve öğretmenlerin her gönderimin Öğrenci Çalışması İnceleme iframe'ini açmaları gerektiğinden, bu durum özellikle sorunsuz bir kullanıcı deneyimi sağlamayabilir.

Ödev notlarındaki değişiklikleri tespit etme

bir ödev oluşturulduktan sonra öğretmenler, Classroom'daki not ayarlarını düzenleyebilir. Bu tür düzenlemeler şunları içerebilir:

Atanan puan değeri değiştiriliyor.
Bir ödevin maxPoints değeri değiştiriliyor.
Ö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 göndermenizi öneririz. Yanıt, mevcut maxPoints değerini içerir. Not verilmemiş bir ödevin değeri boş veya sıfır maxPoints değerine sahiptir.

Classroom'a geri 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. Bu değeri kontrol etmeyi ve gerekirse, ürününüz öğretmenlerin belirli bir etkinlik için öğrencinin puanını düzenlemesine izin veriyorsa güncellemeyi düşünün.