Classroom uygulaması üç tür akış öğesini destekler: CourseWork, CourseWorkMaterials ve Announcements. Bu kılavuzda CourseWork nasıl yönetileceği açıklanmaktadır ancak tüm akış öğelerinin API'leri benzerdir. Yayın öğesi türleri ve aralarındaki farklar hakkında daha fazla bilgi edinmek için API kaynakları bölümüne bakın.
CourseWork kaynağı, belirli bir kurstaki öğrencilere atanmış bir çalışma öğesini temsil eder. Bu öğe, son tarih veya maksimum puan gibi ek materyalleri ve ayrıntıları içerir. CourseWork'nın dört alt türü vardır: ödevler, test ödevleri, kısa yanıtlı sorular ve çoktan seçmeli sorular. Classroom API bu alt türlerden üçünü destekler: ödevler, kısa yanıtlı sorular ve çoktan seçmeli sorular. Bu türler CourseWork.workType alanı ile gösterilir.
CourseWork kaynağına ek olarak, tamamlanan işleri StudentSubmission kaynağıyla da yönetebilirsiniz.
Sınıf çalışması oluşturma
CourseWork yalnızca kursun öğretmeni adına oluşturulabilir.
Bir öğrenci veya kurstaki öğretmen olmayan bir alan yöneticisi adına CourseWork oluşturmaya çalışmak PERMISSION_DENIED hatasına neden olur. Classroom'daki farklı roller hakkında daha fazla bilgi edinmek için Kullanıcı türleri başlıklı makaleyi inceleyin.
courses.courseWork.create yöntemini kullanarak CourseWork oluştururken bağlantıları aşağıdaki örnek kodda gösterildiği gibi materials olarak ekleyebilirsiniz:
Java
Python
title ve workType alanları zorunludur. Diğer tüm alanlar isteğe bağlıdır.
state belirtilmemişse CourseWork taslak durumunda oluşturulur.
Bağlı materyalleri CourseWork'ye dahil etmek için belirtilen bir hedefle Kaynak bağlama'yı kullanın.
url Classroom, title ve küçük resim URL'sini (thumbnailUrl) otomatik olarak getirir. Classroom API, Google Drive ve YouTube materyallerini de benzer şekilde DriveFile kaynağı veya YouTubeVideo kaynağı ile birlikte kullanılabilecek şekilde yerel olarak destekler.
Teslim tarihi belirtmek için dueDate ve dueTime alanlarını ilgili UTC saatine ayarlayın. Son tarih gelecekteki bir tarih olmalıdır.
CourseWork yanıtı, atamaya diğer API isteklerinde referans vermek için kullanılabilecek sunucu tarafından atanmış bir tanımlayıcı içerir.
Retrieve CourseWork
İlgili kursun öğrencileri ve öğretmenleri adına CourseWork alabilirsiniz. Ayrıca, kursun öğretmeni olmasalar bile alan adı yöneticileri adına CourseWork alabilirsiniz. Belirli bir CourseWork öğesini almak için courses.courseWork.get kullanın. Tümünü almak için
CourseWork (isteğe bağlı olarak bazı ölçütlerle eşleşir) courses.courseWork.list kullanın.
Gerekli kapsam, istekte bulunan kullanıcının kurstaki rolüne bağlıdır. Kullanıcı öğrenciyse aşağıdaki kapsamları kullanın:
https://www.googleapis.com/auth/classroom.coursework.me.readonlyhttps://www.googleapis.com/auth/classroom.coursework.me
Kullanıcı bir öğretmen veya alan yöneticisiyse aşağıdaki kapsamları kullanın:
https://www.googleapis.com/auth/classroom.coursework.students.readonlyhttps://www.googleapis.com/auth/classroom.coursework.students
Bir CourseWork'yı alma izninin olması, materyallere veya materyal meta verilerine erişim izni olduğu anlamına gelmez. Bu durum, uygulamada bir yöneticinin kursun üyesi olmaması halinde ekli bir Drive dosyasının başlığını göremeyebileceği anlamına gelir.
Öğrenci yanıtlarını yönetme
StudentSubmission kaynağı, bir öğrencinin CourseWork için yaptığı çalışmayı temsil eder. Kaynak, çalışmayla ilgili meta veriler (ör. çalışma durumu ve not) içerir. Yeni bir CourseWork oluşturulduğunda her öğrenci için örtülü olarak bir StudentSubmission oluşturulur.
Aşağıdaki bölümlerde, öğrenci yanıtlarını yönetmek için kullanılan yaygın işlemler açıklanmaktadır.
Öğrenci yanıtlarını alma
Öğrenciler kendi gönderimlerini, öğretmenler derslerindeki tüm öğrencilerin gönderimlerini, alan yöneticileri ise alanlarındaki tüm öğrencilerin tüm gönderimlerini alabilir. Her StudentSubmission öğesine bir tanımlayıcı atanır. Tanımlayıcıyı biliyorsanız gönderimi almak için courses.courseWork.studentSubmissions.get kullanın.
Aşağıdaki örnekte gösterildiği gibi, bazı ölçütlere uyan tüm courses.courseWork.studentSubmissions.list kaynaklarını almak için StudentSubmission yöntemini kullanın:
Java
Python
Aşağıdaki örnekte gösterildiği gibi StudentSubmission parametresini belirterek belirli bir öğrenciye ait StudentSubmission kaynaklarını alın:userId
Java
Python
Öğrenciler, Student kaynağında belirtildiği gibi benzersiz kimlik veya e-posta adresiyle tanımlanır. Mevcut kullanıcı, "me" kısaltmasını kullanarak kendi kimliğine de başvurabilir.
Bir kurstaki tüm ödevler için öğrenci gönderimlerini de alabilirsiniz. Bunu yapmak için aşağıdaki örnekte gösterildiği gibi courseWorkId olarak "-" değişmezini 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()
Gerekli 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.readonlyhttps://www.googleapis.com/auth/classroom.coursework.students
Kullanıcı öğrenciyse aşağıdaki kapsamı kullanın:
https://www.googleapis.com/auth/classroom.coursework.me.readonlyhttps://www.googleapis.com/auth/classroom.coursework.me
StudentSubmission alma izni, ekler veya ek meta verilerine erişim izni olduğu anlamına gelmez. Bu durum, uygulamada bir yöneticinin kursun üyesi olmaması halinde ekli bir Drive dosyasının başlığını göremeyebileceği anlamına gelir.
Öğrenci yanıtına ek ekleme
Link, DriveFile veya YouTubeVideo kaynağı ekleyerek öğrenci gönderimine bağlantı ekleyebilirsiniz. Bu işlem, aşağıdaki örnekte gösterildiği gibi courses.courseWork.studentSubmissions.modifyAttachments ile yapılır:
Java
Python
Link ek, hedef url tarafından tanımlanır. Classroom, title ve küçük resim (thumbnailUrl) öğesini otomatik olarak getirir. StudentSubmissions öğesine eklenebilecek materyaller hakkında bilgi edinmek için Material bölümüne bakın.
StudentSubmission yalnızca kurs öğretmeni veya sahibi olan öğrenci tarafından değiştirilebilir. Yalnızca StudentSubmission öğesinin CourseWorkType ASSIGNMENT ise Materials ekleyebilirsiniz.
Gerekli 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