Classroom kullanıcı arayüzü beş Sınıf Çalışması türünü destekler: Ödevler, Test Ödevleri, Kısa yanıtlı sorular, Çoktan seçmeli sorular ve Materyaller. Classroom API, şu anda API için CourseWorkType
olarak bilinen şu türlerin üçünü desteklemektedir: Ödevler, Kısa yanıtlı sorular ve Çoktan seçmeli sorular.
Materials
eklenmesini destekler: Ödevler, Kısa yanıtlı sorular ve Çoktan seçmeli sorular
Bu işleve erişmek için teslim tarihi veya maksimum puan gibi ek materyaller ve ayrıntılar dahil olmak üzere belirli bir kurstaki öğrencilere atanan bir Ödev veya Soruyu temsil eden CourseWork kaynağını kullanabilirsiniz.
CourseWork kaynağına ek olarak, tamamlanan ödevleri StudentSubmission
kaynağıyla da yönetebilirsiniz. İlerleyen bölümlerde bunlar
daha ayrıntılı şekilde açıklanmaktadır.
Ödev oluşturma
Ödevler yalnızca dersin öğretmenleri adına oluşturulabilir ve derste öğrenci adına ödev oluşturmaya çalıştığınızda 403 PERMISSION_DENIED
hatası oluşur. Benzer şekilde, alan yöneticileri de eğitim vermedikleri dersler için ödev oluşturamaz ve API üzerinden bu işlemi yapmaya çalıştıklarında 403 PERMISSION_DENIED
hatası oluşur.
courses.courseWork.create
yöntemini kullanarak ödev oluştururken aşağıdaki örnek kodda gösterilen bağlantıları materials
olarak ekleyebilirsiniz:
Java
Python
Sonuç, diğer API isteklerindeki atamaya referans vermek için kullanılabilecek, sunucu tarafından atanan bir tanımlayıcı içerir.
Classroom API aracılığıyla oluşturulan bir ödeve bağlantılı materyaller eklemek için hedef URL'yi belirten bir Bağlantı kaynağı kullanın. Classroom, başlığı ve küçük resmi otomatik olarak getirir. Classroom API, benzer şekilde DriveFile kaynağı veya YouTubeVideo kaynağı ile eklenebilen Google Drive ve YouTube materyallerini de yerel olarak destekler.
Bir teslim tarihi belirtmek için dueDate
ve dueTime
alanlarını karşılık gelen UTC saatine ayarlayın. Teslim tarihi gelecekteki bir tarih olmalıdır.
Ödevleri ve soruları alın
İlgili dersin öğrencileri ve öğretmenleri için ya da alan yöneticisi tarafından gönderilen ödev ve soruları alabilirsiniz. Belirli bir ödevi veya soruyu almak için course.courseWork.get programını kullanın. Tüm ödevleri veya soruları (isteğe bağlı olarak bazı ölçütleri karşılayan) almak içincourses.courseWork.list'i kullanın.
Gereken kapsam, istekte bulunan kullanıcının kurstaki rolüne bağlıdır. Kullanıcı bir öğrenciyse aşağıdaki kapsamlardan birini kullanın:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
Kullanıcı bir öğretmen veya alan yöneticisiyse aşağıdaki kapsamlardan birini kullanın:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
Ödev veya soruyu alma izninin olması, materyallere ya da malzeme meta verilerine erişim izni olduğu anlamına gelmez. Pratikte bu, dersin üyesi olmayan bir yöneticinin, ekli Drive dosyasının başlığını göremeyebileceği anlamına gelir. Yöneticilerin kullanıcı dosyalarına erişmesine izin vermek istiyorsanız alan genelinde yetki verme kılavuzuna bakın.
Öğrenci yanıtlarını yönetme
StudentSubmission
kaynağı, öğrencinin bir ödev veya soru için verdiği çalışmayı ve not verdiği süreyi temsil eder. Yeni bir soru veya ödev oluşturulduğunda her öğrenci için dolaylı olarak bir StudentSubmission
kaynağı oluşturulur.
Aşağıdaki bölümlerde, öğrenci yanıtlarını yöneten yaygın işlemler açıklanmaktadır.
Öğrenci yanıtlarını alma
Öğrenciler kendi gönderimlerini alabilir, öğretmenler derslerindeki tüm öğrencilerin gönderimlerini alabilir ve alan yöneticileri alanlarındaki tüm öğrencilerin gönderimlerini alabilir. Her öğrenci gönderimine bir tanımlayıcı atanır. Tanımlayıcıyı biliyorsanız bunu almak için courses.courseWork.studentSubmissions.get
aracını kullanın.
Aşağıdaki örnekte gösterildiği gibi, bazı kriterlerle eşleşen StudentSubmission
kaynaklarını almak için courses.courseWork.studentSubmissions.list
yöntemini kullanın:
Java
Python
Aşağıdaki örnekte gösterildiği gibi, userId
parametresini belirterek belirli bir öğrenciye ait StudentSubmission
kaynaklarını alın:
Java
Python
Öğrenciler, Google Yönetici Konsolu SDK'sı tarafından döndürülen, kullanıcının benzersiz kimliği veya e-posta adresiyle tanımlanır. Mevcut kullanıcı, "me"
kısaltmasını kullanarak kendi kimliğine de başvurabilir.
Öğrencilerin bir kurs içindeki tüm ödevler için gönderimlerini de alabilirsiniz. Bunun için aşağıdaki örnekte gösterildiği gibi "-"
değişmez değerini courseWorkId
olarak kullanın:
Java
service.courses().courseWork().studentSubmissions()
.list(courseId, "-")
.set("userId", userId)
.execute();
Python
service.courses().courseWork().studentSubmissions().list(
courseId=<course ID or alias>,
courseWorkId='-',
userId=<user ID>).execute()
Gereken kapsam, istekte bulunan kullanıcının kurstaki rolüne bağlıdır. Kullanıcı bir öğretmen veya alan yöneticisiyse aşağıdaki kapsamı kullanın:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
Kullanıcı öğrenciyse aşağıdaki kapsamı kullanın:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
Öğrencinin bir ödevini alma izninin olması, eklere veya ek meta verilerine erişim izni olduğu anlamına gelmez. Pratikte bu, bir yöneticinin kursun üyesi değilse eklenen Drive dosyasının başlığını göremeyeceği anlamına gelir. Yöneticilerin kullanıcı dosyalarına erişmesine izin vermek istiyorsanız alan genelinde yetki kılavuzuna bakın.
Öğrenci yanıtına dosya ekleme
Link
, DriveFile
veya YouTubeVideo
kaynağı ekleyerek öğrenci gönderimlerine bağlantı ekleyebilirsiniz. Bu işlem, aşağıdaki örnekte gösterildiği gibi courses.courseWork.studentSubmissions.modifyAttachments
ile yapılır:
Java
Python
Bağlantı eki, hedef URL tarafından tanımlanır. Classroom, başlığı ve küçük resmi otomatik olarak getirir. İlgili referans sayfalarından diğer malzemeler hakkında bilgi edinebilirsiniz.
StudentSubmission
yalnızca ders öğretmeni veya sahibi olan öğrenci tarafından değiştirilebilir. Materials
öğesini yalnızca öğrenci gönderiminin CourseWorkType
öğesi ASSIGNMENT
ise ekleyebilirsiniz.
Gereken kapsam, istekte bulunan kullanıcının kurstaki rolüne bağlıdır. Kullanıcı bir öğretmense aşağıdaki kapsamı kullanın:
https://www.googleapis.com/auth/classroom.coursework.students
Kullanıcı öğrenciyse aşağıdaki kapsamı kullanın:
https://www.googleapis.com/auth/classroom.coursework.me
Öğrenci yanıt durumunu yönetme
Öğrencinin yanıtı iptal edilmiş, teslim edilmiş veya geri verilmiş olabilir. StudentSubmission
içindeki durum alanı geçerli durumu gösterir. Durumu değiştirmek için aşağıdaki yöntemlerden birini çağırın:
courses.courseWork.studentSubmissions.turnIn
courses.courseWork.studentSubmissions.return
courses.courseWork.studentSubmissions.reclaim
Bu yöntemlerin tümü boş bir gövde alır. Örnek:
Java
Python
service.courses().courseWork().studentSubmission().turnIn(
courseId=<course ID or alias>,
courseWorkId=<courseWork ID>,
id=<studentSubmission ID>,
body={}).execute()
Yalnızca StudentSubmission
sahibi olan öğrenci teslim edebilir veya üzerinde yeniden hak talebinde bulunabilir.
Yalnızca teslim edilen bir gönderim geri alınabilir. Ders öğretmenleri yalnızca teslim edilmiş durumda olan bir StudentSubmission
öğesini geri verebilir.
Öğrenci yanıtlarına not verme
StudentSubmission
kaynağında notları depolamak için iki alan bulunur:
assignedGrade
öğrencilere bildirilen not ve draftGrade
(
yalnızca öğretmenler tarafından görülebilen geçici bir not). Bu alanlar, aşağıdaki örnekte gösterildiği gibi courses.courseWork.studentSubmissions.patch
kullanılarak uygun alanları içeren bir alan maskesi ile güncellenir.
Java
Python
studentSubmission = {
'assignedGrade': 99,
'draftGrade': 80
}
service.courses().courseWork().studentSubmissions().patch(
courseId=<course ID or alias>,
courseWorkId=<courseWork ID>,
id=<studentSubmission ID>,
updateMask='assignedGrade,draftGrade',
body=studentSubmission).execute()
Classroom kullanıcı arayüzüyle çalışırken, öğretmenler ilk önce taslak notu kaydedene kadar not atayamaz. Atanan not, öğrenciye geri verilebilir. Uygulamaların bu davranışı emüle etmesi gerekir. Uygulamanız, bir öğrencinin ödevine iki şekilde not verebilir:
Yalnızca
draftGrade
atayın. Bu özellik, örneğin, öğretmenin notları kesinleştirmeden önce notları manuel olarak gözden geçirmesini sağlamak açısından yararlıdır. Öğrenciler geçici notları göremez.Bir ödeve tam not vermek için hem
draftGrade
hem deassignedGrade
atayın.
Atanan notları listeleme
courses.courseWork.studentSubmissions.list
yönteminin yanıt nesnesini inceleyerek belirli bir sınıf çalışması öğesi için tüm notları listeleyebilirsiniz:
Java
Python
response = coursework.studentSubmissions().list(
courseId=course_id,
courseWorkId=coursework_id,
pageSize=10).execute()
submissions.extend(response.get('studentSubmissions', []))
if not submissions:
print('No student submissions found.')
print('Student Submissions:')
for submission in submissions:
print(f"Submitted at:"
f"{(submission.get('userId'), submission.get('assignedGrade'))}")