REST Resource: courses.courseWork.studentSubmissions

Kaynak: StudentSubmission

Sınıf çalışması için öğrenci gönderimi.

CourseWork öğesi oluşturulduğunda StudentSubmission öğe oluşturulur.

Hiç erişilmemiş olan (ör. state = YENİ olan) öğrenci gönderimlerinde 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

İlgili sınıf çalışmasının tanımlayıcısı.

Salt okunur.
id

string

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

string

Bu gönderimin sahibi olan öğrencinin tanımlayıcısı.

Salt okunur.
creationTime

string (Timestamp format)

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

Salt okunur.

Nanosaniye çözünürlüğüne ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Bu gönderimin son güncellenme zamanı. Öğrenci bu öğeye erişmediyse bu ayar kaldırılabilir.

Salt okunur.

Nanosaniye çözünürlüğüne ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
state

enum (SubmissionState)

Bu gönderimin durumu.

Salt okunur.
late

boolean

Gönderimin gecikip gecikmediği bilgisi.

Salt okunur.
draftGrade

number

İ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 tarafından görülebilir ve değiştirilebilir.
assignedGrade

number

İ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

string

Yalnızca çıkış. Şu anda bu sınıf çalışmasına ekli ve öğrencinin gönderdiği bu ödeve not vermek için kullanılan puan anahtarının tanımlayıcısı.

Puan anahtarı yoksa bu kimlik boş olur. Bu kimlik, o anda etkin olan puan anahtarını yansıtır. Öğretmenler puan anahtarını silip yeniden oluşturduğunda değişir.

Salt okunur.

draftRubricGrades

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

Puan anahtarının ölçütlerine göre beklemedeki 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çüt için 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.

"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çütleri temel alınarak puan anahtarı notları atanır.

Bu sınıf çalışmasına ekli bir puan anahtarı yoksa veya bir 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.

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

enum (CourseWorkType)

Bu gönderimin ilgili sınıf çalışması türü.

Salt okunur.
associatedWithDeveloper

boolean

Bu öğrenci ödevinin, istekte bulunan Developer Console projesiyle ilişkili olup olmadığı.

Ayrıntılı bilgi için courseWork.create ile iletişime geçin.

Salt okunur.
submissionHistory[]

object (SubmissionHistory)

Gönderim geçmişi (eyalet ve not geçmişlerini içerir).

Salt okunur.
previewVersion

enum (PreviewVersion)

Yalnızca çıkış. API'nin önizleme sürümü. Önizleme Programı'nda geliştiricilere sunulan yeni API özelliklerine erişebilmek için bu ayarın ayarlanması gerekir.
Birlik alanı content. Gönderim içeriği. Belirli tür, course_work_type değerine bağlıdır. content şunlardan yalnızca biri olabilir:
assignmentSubmission

object (AssignmentSubmission)

derWorkType ASSIGNMENT olduğunda içerik gönderin.

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

object (ShortAnswerSubmission)

kursWorkType SHORT_ANSWER_QUESTION olduğunda içeriği gönderin.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

kursWorkType şu olduğunda içeriği gönderin: MULTIPLE_CHOICE_QUESTION.

RubricGrade

Öğrencinin gönderimi için belirlenmiş bir 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 seviye seçilmedi.
points

number

İsteğe bağlı. Bu ölçüt için genellikle seviye temel alınarak atanan isteğe bağlı puanlar. Seviyelerde puan bulunabilir veya bulunmayabilir. Ayarlanmadan bırakılırsa bu ölçüt için herhangi bir puan ayarlanmadı.

AssignmentSubmission

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

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

object (Attachment)

Öğrenci tarafından ekler eklendi. Öğ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. Identifier ve alternateLink alanları her zaman kullanılabilir ancak diğerleri (ör. başlık) kullanılamayabilir.

Ek

Öğrenci ödevi çalışmasına dosya 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
Birlik 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

Kısa cevaplı bir soruya öğrenci yanıtı.

MultipleChoiceSubmission

Çoktan seçmeli bir soru için öğrenci çalışması.

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

string

Öğrencinin yaptığı seçim.

SubmissionHistory

Gönderimin geçmişi. Şu anda eyalet ve not geçmişleri de buna dahildir.

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
Birlik alanı type. SubmissionHistory türü; StateHistory, GradeHistory değerlerinden biri olabilir. type şunlardan yalnızca biri olabilir:
stateHistory

object (StateHistory)

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

object (GradeHistory)

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

StateHistory

Bu gönderimin bulunduğu her durumun 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.

Nanosaniye çözünürlüğüne ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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ö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, şablon olabilecek atanmış bir dokümanı teslim etti.
RETURNED Öğretmen, kendisine atanan dokümanı öğrenciye geri vermiştir.
RECLAIMED_BY_STUDENT Öğrenci, kendisine atanan dokümanı teslim etti ve ardından ödevin "gönderimini iptal etmeyi" seçerek ödevin sahibi olma kontrolünü öğrenciye tekrar verdi.
STUDENT_EDITED_AFTER_TURN_IN Öğrenci, tesliminden sonra ödevini düzenlemiştir. Şu anda yalnızca Sorular tarafından öğrenci yanıtını düzenlerken 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şinde mevcut notun payı.
maxPoints

number

Gönderim not geçmişinde şu andaki toplam not değeri.
gradeTimestamp

string (Timestamp format)

Gönderimin notunun değiştirilme zamanı.

Nanosaniye çözünürlüğüne ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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şindeki mevcut 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ında değişiklik.
MAX_POINTS_CHANGE Notun paydasında değişiklik.

Yöntemler

get

 Öğrencinin gönderdiği çalışmayı geri verir.

list

 İ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.

modifyAttachments

 Öğrencinin gönderdiği gönderim eklerinde değişiklik yapar.

patch

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

reclaim

 Öğrencinin gönderdiği ödevler, sahibi olan öğrenci adına geri talep edilir.

return

 Öğrencinin gönderdiği çalışmayı geri verir.

turnIn

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