- Kaynak: StudentSubmission
- RubricGrade
- AssignmentSubmission
- Ek
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- Durum
- GradeHistory
- GradeChangeType
- Yöntemler
Kaynak: Öğrenci Gönderimi
Sınıf çalışması için öğrenci gönderimi.
CourseWork
öğesi oluşturulduğunda StudentSubmission
öğe oluşturulur.
Daha önce hiç erişilmemiş öğrenci gönderimlerinin (ör. state
= YENİ ile) oluşturma zamanı veya güncelleme zamanı olmayabilir.
JSON gösterimi |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
Alanlar | |
---|---|
courseId |
Kursun tanımlayıcısı. Salt okunur. |
courseWorkId |
İlgili sınıf çalışmasının tanımlayıcısı. Salt okunur. |
id |
Öğrenci gönderimi için Classroom tarafından atanan tanımlayıcı. Bu, ilgili sınıf çalışması gönderimleri arasında benzersizdir. Salt okunur. |
userId |
Bu gönderimin sahibi olan öğrencinin tanımlayıcısı. Salt okunur. |
creationTime |
Bu gönderimin oluşturulma zamanı. Öğrenci bu öğeye erişmediyse bu ayar kaldırılabilir. Salt okunur. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
updateTime |
Bu gönderimin son güncellenme zamanı. Öğrenci bu öğeye erişmediyse bu ayar kaldırılabilir. Salt okunur. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
state |
Bu gönderimin durumu. Salt okunur. |
late |
Bu gönderimin gecikip gecikmediği. Salt okunur. |
draftGrade |
İsteğe bağlı beklemedeki not. Ayarlanmadan bırakılırsa not ayarlanmaz. Bu değer, negatif olmayan bir sayı olmalıdır. Ondalık (yani tam sayı olmayan) değerlere izin verilir ancak bu değerler iki ondalık basamağa yuvarlanır. Bu ayarı yalnızca ders öğretmenleri görebilir ve değiştirebilir. |
assignedGrade |
İsteğe bağlı not. Ayarlanmadan bırakılırsa not ayarlanmaz. Bu değer, negatif olmayan bir sayı olmalıdır. Ondalık (yani tam sayı olmayan) değerlere izin verilir ancak bu değerler iki ondalık basamağa yuvarlanır. Bu ayar yalnızca ders öğretmenleri tarafından değiştirilebilir. |
rubricId |
Yalnızca çıkış. Şu anda bu sınıf çalışmasına ekli olan ve bu öğrenci gönderimine not vermek için kullanılan puan anahtarının tanımlayıcısı. Puan anahtarı yoksa bu kimlik boş olur. Bu kimlik, geçerli olarak etkin olan puan anahtarını yansıtır. Öğretmenler puan anahtarını silip yeniden oluşturduğunda değişir. Salt okunur. |
draftRubricGrades |
Puan anahtarı ölçütlerine göre puan anahtarı notları. Bu sınıf çalışmasına eklenmiş puan anahtarı yoksa veya puan anahtarı eklenmişse ancak herhangi bir ölçütte not ayarlanmadıysa bu harita boş olur. Yalnızca belirlenen notlar için giriş yapılır. Anahtar: Puan anahtarının ölçüt kimliği. Salt okunur.
|
assignedRubricGrades |
Puan anahtarı notları, değerlendirme ölçeğinin Ölçütlerine göre atanmıştır. Sınıf çalışmasına eklenen puan anahtarı yoksa veya puan anahtarı eklenmişse ancak herhangi bir Ölçütte not ayarlanmamışsa bu harita boş olur. Yalnızca belirlenen notlar için giriş yapılır. Anahtar: Puan anahtarının ölçüt kimliği. Salt okunur.
|
alternateLink |
Classroom web kullanıcı arayüzünde gönderimin mutlak bağlantısı. Salt okunur. |
courseWorkType |
Bu gönderimin hangi sınıf çalışması türü. Salt okunur. |
associatedWithDeveloper |
Bu öğrenci gönderisinin, istekte bulunan Developer Console projesiyle ilişkili olup olmadığı. Ayrıntılı bilgi için Salt okunur. |
submissionHistory[] |
Gönderim geçmişi (eyalet ve not geçmişlerini içerir). Salt okunur. |
previewVersion |
Yalnızca çıkış. API'nin önizleme sürümü. Bu, Önizleme Programı'nda geliştiricilere sunulan yeni API özelliklerine erişmek için ayarlanmalıdır. |
content alanı. Gönderim içeriği. Bu tür, course_work_type değerine bağlıdır. content şunlardan yalnızca biri olabilir: |
|
assignmentSubmission |
courseWorkType ASSIGNMENT olduğunda içerik gönderin. Öğrenciler |
shortAnswerSubmission |
courseWorkType SHORT_ANSWER_QUESTION olduğunda içeriği gönderin. |
multipleChoiceSubmission |
courseWorkType MULTIPLE_CHOICE_QUESTION olduğunda içeriği gönderin. |
RubricGrade
Öğrenci gönderimi için bir değerlendirme ölçeği notu. Puan anahtarı ölçütü başına en fazla bir giriş vardır.
JSON gösterimi |
---|
{ "criterionId": string, "levelId": string, "points": number } |
Alanlar | |
---|---|
criterionId |
İsteğe bağlı. Ölçüt kimliği. |
levelId |
İsteğe bağlı. Seçilen seviyenin isteğe bağlı seviye kimliği. Boş bırakılırsa seviye seçilmedi demektir. |
points |
İsteğe bağlı. Bu ölçüt için genellikle seviye temel alınarak verilen isteğe bağlı puanlar. Seviyelerde puan bulunabilir veya bulunmayabilir. Ayarlanmadan bırakılırsa bu ölçüt için hiç puan ayarlanmadı demektir. |
AssignmentSubmission
Öğrencinin bir ödev için çalışması.
JSON gösterimi |
---|
{
"attachments": [
{
object ( |
Alanlar | |
---|---|
attachments[] |
Öğrenci tarafından eklenen ekler. Öğrenci Classroom'da ödeve erişmediyse STUDENT_COPY paylaşım moduyla materyallere karşılık gelen Drive dosyaları henüz mevcut olmayabilir. Bazı ek meta verileri yalnızca istekte bulunan kullanıcının erişim izni olduğunda doldurulur. Tanımlayıcı ve alternateLink alanları her zaman kullanılabilir ancak diğerleri (ör. başlık) kullanılamayabilir. |
Ek
Ek, öğrenci ödevi çalışmasına eklendi.
Ek oluştururken form
alanının ayarlanması desteklenmez.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
attachment alanı. Ek verileri. attachment şunlardan yalnızca biri olabilir: |
|
driveFile |
Google Drive dosya eki. |
youTubeVideo |
YouTube videosu eki. |
link |
Bağlantı eki. |
form |
Google Formlar eki. |
ShortAnswerSubmission
Öğrencinin kısa cevaplı bir soru için çalışması.
JSON gösterimi |
---|
{ "answer": string } |
Alanlar | |
---|---|
answer |
Öğrencinin kısa yanıtlı bir soruya verdiği yanıt. |
MultipleChoiceSubmission
Çoktan seçmeli sorular için öğrenci çalışmaları.
JSON gösterimi |
---|
{ "answer": string } |
Alanlar | |
---|---|
answer |
Öğrencinin seçimi. |
SubmissionHistory
Gönderimin geçmişi. Şu anda eyalet ve not geçmişleri de buna dahildir.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
type alanı. SubmissionHistory türü, StateHistory veya GradeHistory'den biri olabilir. type şunlardan yalnızca biri olabilir: |
|
stateHistory |
Varsa gönderimin durum geçmiş bilgileri. |
gradeHistory |
Varsa gönderimin not geçmişi bilgileri. |
StateHistory
Bu gönderimin bulunduğu her eyaletin geçmişi.
JSON gösterimi |
---|
{
"state": enum ( |
Alanlar | |
---|---|
state |
İş akışı ardışık düzeni aşaması. |
stateTimestamp |
Gönderim bu duruma girdiğinde. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
actorUserId |
Değişikliği yapan öğretmen veya öğrenci. |
Eyalet
Gönderim için olası durumlar.
Sıralamalar | |
---|---|
STATE_UNSPECIFIED |
Eyalet belirtilmedi. Bu değer asla döndürülmemelidir. |
CREATED |
Gönderim oluşturuldu. |
TURNED_IN |
Öğrenci, atanmış bir dokümanı teslim etti. Bu doküman şablon olabilir veya olmayabilir. |
RETURNED |
Öğretmen, atanan dokümanı öğrenciye geri verdi. |
RECLAIMED_BY_STUDENT |
Öğrenci atanan dokümanı teslim etti ve ardından ödevin "gönderimini iptal etmeyi" tercih etti. Bu sayede, ödevin sahibi olarak öğrenci kontrolü tekrar etkin hale geldi. |
STUDENT_EDITED_AFTER_TURN_IN |
Öğrenci, teslim ettikten sonra ödevini düzenlemiştir. Şu anda yalnızca Sorular tarafından öğrenci yanıtını düzenlediğinde kullanılır. |
GradeHistory
Bu gönderimdeki her notun geçmişi.
JSON gösterimi |
---|
{
"pointsEarned": number,
"maxPoints": number,
"gradeTimestamp": string,
"actorUserId": string,
"gradeChangeType": enum ( |
Alanlar | |
---|---|
pointsEarned |
Gönderim not geçmişinde mevcut notun payıdır. |
maxPoints |
Gönderim not geçmişinde şu anki notun toplam değeri. |
gradeTimestamp |
Gönderimin notunun değiştirilme zamanı. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
actorUserId |
Not değişikliğini yapan öğretmen. |
gradeChangeType |
Gönderim not geçmişinde geçerli olan not değişikliğinin türü. |
GradeChangeType
Olası not değişikliği türleri.
Sıralamalar | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
Not değişikliği türü belirtilmedi. Bu değer asla döndürülmemelidir. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
Geçici notun payında değişiklik. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
Atanan notun payındaki değişiklik. |
MAX_POINTS_CHANGE |
Not paydasında değişiklik. |
Yöntemler |
|
---|---|
|
Öğrencinin gönderimini döndürür. |
|
İsteğin OAuth kapsamları dikkate alınarak, istekte bulunan kişinin görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür. |
|
Öğrenci gönderim eklerinde değişiklik yapar. |
|
Öğrenci gönderiminin bir veya daha fazla alanını günceller. |
|
Öğrencinin gönderdiği bir ödevi, sahibi olan öğrenci adına geri alır. |
|
Öğrencinin gönderimini döndürür. |
|
Öğrencinin gönderdiği bir ödevi teslim eder. |