REST Resource: courses.courseWork.studentSubmissions

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 erişilmemiş öğrenci gönderimlerinin (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 (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
Alanlar
courseId

string

Kursun tanımlayıcısı.

Salt okunur.
courseWorkId

string

Buna karşılık gelen sınıf çalışmasının tanımlayıcısı.

Salt okunur.
id

string

Öğrencinin gönderimi için Classroom tarafından atanan Tanımlayıcı. Bu, ilgili sınıf çalışması için yapılan gönderimler arasında benzersizdir.

Salt okunur.
userId

string

Bu gönderimin sahibi olan öğrencinin kimliği.

Salt okunur.
creationTime

string (Timestamp format)

Bu gönderimin oluşturulma zamanı. Öğrenci bu öğeye erişmediyse bu ayar ayarlanabilir.

Salt okunur.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Bu gönderimin son güncelleme zamanı. Öğrenci bu öğeye erişmediyse bu ayar ayarlanabilir.

Salt okunur.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
state

enum (SubmissionState)

Bu gönderimin durumu.

Salt okunur.
late

boolean

Bu gönderimin geç olup olmadığı.

Salt okunur.
draftGrade

number

İsteğe bağlı bekleyen not. Ayarlanmadan bırakılırsa not verilmedi. Bu değer, negatif olmayan bir sayı olmalıdır. Ondalık (yani tam sayı olmayan) değerlere izin verilir ancak bunlar iki ondalık basamağa yuvarlanır.

Bu ayar yalnızca ders öğretmenleri tarafından görülebilir ve değiştirilebilir.
assignedGrade

number

İsteğe bağlı not. Ayarlanmadan bırakılırsa not verilmedi. Bu değer, negatif olmayan bir sayı olmalıdır. Ondalık (yani tam sayı olmayan) değerlere izin verilir ancak bunlar iki ondalık basamağa yuvarlanır.

Bu ayar yalnızca ders öğretmenleri tarafından değiştirilebilir.
rubricId

string

Yalnızca çıkış. Şu anda bu ders ç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, şu anda etkin olan puan anahtarını yansıtır. öğretmenler puan anahtarını silip yeniden oluşturursa puan değişir.

Salt okunur.

draftRubricGrades

map (key: string, value: object (RubricGrade))

Puan anahtarının ölçütlerine göre bekleyen puan anahtarı notları.

Bu sınıf çalışmasına ekli bir puan anahtarı yoksa veya bir puan anahtarı eklenmişse ancak herhangi bir ölçütle herhangi bir not belirlenmemişse bu harita boş olur. Girişler yalnızca belirlenen notlar için doldurulur. Anahtar: Puan anahtarının ölçüt kimliği.

Salt okunur.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignedRubricGrades

map (key: string, value: object (RubricGrade))

Puan anahtarının Ölçütlerine göre puan anahtarı notları atandı.

Bu sınıf çalışmasına ekli bir puan anahtarı yoksa veya bir değerlendirme ölçeği eklenmişse ancak herhangi bir Kriter'de herhangi bir not ayarlanmamışsa bu harita boş olur. Girişler yalnızca belirlenen notlar için doldurulur. Anahtar: Puan anahtarının ölçüt kimliği.

Salt okunur.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

Bu gönderimin ait olduğu sınıf çalışması türü.

Salt okunur.
associatedWithDeveloper

boolean

Bu öğrenci gönderisinin, istekte bulunan Geliştirici Konsolu projesiyle ilişkili olup olmadığı.

Ayrıntılı bilgi için courseWork.create sayfasını inceleyin.

Salt okunur.
submissionHistory[]

object (SubmissionHistory)

Ödev geçmişi (durum ve not geçmişlerini içerir).

Salt okunur.
previewVersion

enum (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.
Birleştirme alanı content. Gönderim içeriği. Özel tür, course_work_type değerine bağlıdır. content şunlardan yalnızca biri olabilir:
assignmentSubmission

object (AssignmentSubmission)

kursWorkType ASSIGNMENT olduğunda gönderim içeriği.

Öğrenciler studentSubmissions.modifyAttachments kullanarak bu içeriği değiştirebilir.
shortAnswerSubmission

object (ShortAnswerSubmission)

speechWorkType SHORT_ANSWER_QUESTION olduğunda gönderim içeriği.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

speechWorkType MULTIPLE_CHOICE_QUESTION olduğunda gönderim içeriği.

RubricGrade

Öğrencinin gönderimi için puan anahtarı notu. Puan anahtarı ölçütü başına en fazla bir giriş vardır.

JSON gösterimi 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
Alanlar
criterionId

string

İsteğe bağlı. Ölçüt Kimliği.
levelId

string

İsteğe bağlı. Seçilen seviyenin isteğe bağlı seviye kimliği. Boşsa hiçbir seviye seçilmediyse
points

number

İsteğe bağlı. Bu ölçüt için atanan isteğe bağlı puanlar (genellikle seviyeye göre). Seviyelerde puan olabilir veya olmayabilir. Ayarlanmadan bırakılırsa bu ölçüt için puan ayarlanmadı.

AssignmentSubmission

Ödev için öğrenci çalışması.

JSON gösterimi 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Alanlar
attachments[]

object (Attachment)

Öğrenci tarafından eklenen ekler. Öğrenci Classroom'da ödeve erişmediyse STUDENT_COPY paylaşım moduna sahip 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. Identifier veAlternativeLink 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 attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
Alanlar
Birleştirme alanı attachment. Ek verileri. attachment şunlardan yalnızca biri olabilir:
driveFile

object (DriveFile)

Google Drive dosya eki.
youTubeVideo

object (YouTubeVideo)

YouTube videosu eki.
form

object (Form)

Google Formlar eki.

ShortAnswerSubmission

Kısa cevaplı bir soru için öğrenci çalışması.

JSON gösterimi 
{
  "answer": string
}
Alanlar
answer

string

Öğ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

string

Öğrencinin seçimi.

SubmissionHistory

Gönderim geçmişi. Şu an için eyalet ve not geçmişleri bu kapsama girmektedir.

JSON gösterimi 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
Alanlar
Birleştirme alanı type. SubmissionHistory; StateHistory, GradeHistory'den biri olabilir. type şunlardan yalnızca biri olabilir:
stateHistory

object (StateHistory)

Varsa, gönderimin durum geçmişi bilgileri.
gradeHistory

object (GradeHistory)

Varsa, ödevin not geçmişi bilgileri.

StateHistory

Bu gönderimin bulunduğu her eyaletin geçmişi.

JSON gösterimi 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Alanlar
state

enum (State)

İş akışı ardışık düzeni aşaması.
stateTimestamp

string (Timestamp format)

Gönderimin bu duruma ne zaman girdiği.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
actorUserId

string

Değişikliği yapan öğretmen veya öğrenci.

Eyalet

Gönderimin bulunabileceği olası durumlar.

Sıralamalar
STATE_UNSPECIFIED Eyalet belirtilmedi. Bu bilgi hiçbir zaman 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 "göndermeyi iptal et"i seçti ödevin sahibi olarak tekrar kontrolü öğrenciye verebilir.
STUDENT_EDITED_AFTER_TURN_IN Öğrenci, gönderimini teslim ettikten sonra düzenlemiştir. Şu anda yalnızca Sorular tarafından, öğrenci cevabı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 (GradeChangeType)
}
Alanlar
pointsEarned

number

Gönderim not geçmişindeki notun şu anki payı.
maxPoints

number

Gönderim not geçmişindeki toplam not değeri.
gradeTimestamp

string (Timestamp format)

Gönderimin notunun ne zaman değiştirildiğini

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
actorUserId

string

Not değişikliğini yapan öğretmen.
gradeChangeType

enum (GradeChangeType)

Gönderim not geçmişinde şu anki not değişikliği 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 bilgi hiçbir zaman 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ında değişiklik.
MAX_POINTS_CHANGE Notun toplam not değerinde değişiklik.

Yöntemler

get

 Öğrencinin gönderdiği dosyayı döndürür.

list

 İsteğin OAuth kapsamları da hesaba katılarak, istekte bulunan kişinin görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür.

modifyAttachments

 Öğrenci gönderimlerinin eklerini değiştirir.

patch

 Öğrenci gönderiminin bir veya daha fazla alanını günceller.

reclaim

 Sahibi olan öğrenci adına öğrenci gönderimi için yeniden hak talebinde bulunur.

return

 Öğrencinin gönderdiği dosyayı döndürür.

turnIn

 Öğrencinin gönderdiği çalışmayı teslim eder.