REST Resource: courses.courseWork.studentSubmissions

Kaynak: StudentSubmission

Ödev için öğrenci gönderimi.

Bir CourseWork öğesi oluşturulduğunda StudentSubmission öğeleri oluşturulur.

Hiç erişilmemiş öğrenci gönderimlerinin (ör. state = NEW) oluşturma 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),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
Alanlar
courseId

string

Dersin tanımlayıcısı.

Salt okunur.
courseWorkId

string

Bu notun karşılık geldiği 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ı için gönderimler 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 değer ayarlanmamış olabilir.

Salt okunur.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Bu gönderimin son güncelleme zamanı. Öğrenci bu öğeye erişmediyse bu değer ayarlanmamış olabilir.

Salt okunur.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
state

enum (SubmissionState)

Bu gönderimin durumu.

Salt okunur.
late

boolean

Bu gönderimin gecikip gecikmediği.

Salt okunur.
draftGrade

number

İsteğe bağlı bekleyen not. Ayarlanmadıysa not belirlenmemiştir. 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

number

İsteğe bağlı not. Ayarlanmadıysa not belirlenmemiştir. 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 ödeve eklenmiş olan ve bu öğrenci gönderimini notlandırmak 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 bu kimlik 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 ödeve eklenmiş bir puan anahtarı yoksa veya eklenmiş bir puan anahtarı varsa ancak hiçbir ölçüt için not belirlenmemişse bu eşleme boş olur. Girişler yalnızca ayarlanmış notlar için doldurulur. Anahtar: Puanlama 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 atanmış puan anahtarı notları.

Bu ödeve eklenmiş bir puan anahtarı yoksa veya eklenmiş bir puan anahtarı varsa ancak ölçütlerden herhangi birinde not belirlenmemişse bu eşleme boştur. Girişler yalnızca ayarlanmış notlar için doldurulur. Anahtar: Puanlama 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ının türü.

Salt okunur.
associatedWithDeveloper

boolean

Bu öğrenci gönderiminin, isteği gönderen Developer Console projesiyle ilişkili olup olmadığı.

Daha fazla bilgi için courseWork.create sayfasına bakın.

Salt okunur.
submissionHistory[]

object (SubmissionHistory)

Gönderimin 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ü. Önizleme Programı'ndaki geliştiricilerin kullanımına sunulan yeni API özelliklerine erişmek için bu ayarın yapılması gerekir.
Gönderim içeriği. Belirli tür, course_work_type değerine bağlıdır. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
assignmentSubmission

object (AssignmentSubmission)

courseWorkType, ASSIGNMENT olduğunda gönderim içeriği.

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

object (ShortAnswerSubmission)

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

object (MultipleChoiceSubmission)

courseWorkType, MULTIPLE_CHOICE_QUESTION olduğunda gönderim içeriği.
Birbirini hariç tutan alanların sonu.

RubricGrade

Öğrenci gönderimi için belirlenen 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ıdır. Ölçüt kimliği.
levelId

string

İsteğe bağlıdır. Seçilen seviyenin isteğe bağlı seviye kimliği. Boşsa seviye seçilmemiştir.
points

number

İsteğe bağlıdır. Bu ölçüt için atanan isteğe bağlı puanlar (genellikle seviyeye göre). Seviyelerde puan olabilir veya olmayabilir. Politika ayarlanmazsa bu ölçüt için puan belirlenmez.

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 paylaşım modu STUDENT_COPY olan 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 varsa doldurulur. Identifier ve alternateLink alanları her zaman kullanılabilir ancak diğer alanlar (örneğin, title) kullanılamayabilir.

Ek

Öğrencinin atanan çalışmalarına ek eklendi.

Ek oluştururken form alanını ayarlama desteklenmiyor.

JSON gösterimi 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
Alanlar
Ek verileri. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
driveFile

object (DriveFile)

Google Drive dosya eki.
youTubeVideo

object (YouTubeVideo)

YouTube video eki.
form

object (Form)

Google Formlar eki.
Birbirini hariç tutan alanların sonu.

ShortAnswerSubmission

Kısa yanıtlı soru için öğrenci çalışması.

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

string

Öğrencinin kısa yanıtlı soruya verdiği yanıt.

MultipleChoiceSubmission

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

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

string

Öğrencinin seçimi.

SubmissionHistory

Gönderimin geçmişi. Şu anda durum ve not geçmişleri bu kapsamda yer almaktadır.

JSON gösterimi 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
Alanlar
SubmissionHistory türü, StateHistory veya GradeHistory olabilir. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
stateHistory

object (StateHistory)

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

object (GradeHistory)

Gönderimin not geçmişi bilgileri (varsa).
Birbirini hariç tutan alanların sonu.

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üzen aşaması.
stateTimestamp

string (Timestamp format)

Gönderimin bu duruma girdiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
actorUserId

string

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

Eyalet

Gönderilen çalışmanın bulunabileceği olası durumlar.

Sıralamalar
STATE_UNSPECIFIED Eyalet belirtilmedi. Bu değer 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ğinde.
RECLAIMED_BY_STUDENT Öğrenci, atanan dokümanı teslim etti ve ardından ödevi "göndermeyi iptal etmeyi" seçerek sahip olarak kontrolü tekrar öğrenciye verdi.
STUDENT_EDITED_AFTER_TURN_IN Öğrenci, gönderimini teslim ettikten sonra düzenledi. Şu anda yalnızca öğrenci yanıtını düzenlediğinde Sorular tarafından 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 notu geçmişinde bu zamandaki notun payı.
maxPoints

number

Gönderim notu geçmişinde, bu zamandaki notun paydası.
gradeTimestamp

string (Timestamp format)

Gönderimin notunun değiştirildiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
actorUserId

string

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

enum (GradeChangeType)

Gönderim notu geçmişinde şu anda yapılan 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 hiçbir zaman döndürülmemelidir.
DRAFT_GRADE_POINTS_EARNED_CHANGE Taslak 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

 Öğrenci gönderimini geri verir.

list

 İsteğin OAuth kapsamlarını hesaba katarak, istekte bulunan kullanıcının görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür.

modifyAttachments

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

patch

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

reclaim

 Sahibi olan öğrenci adına bir öğrenci gönderimini geri alır.

return

 Öğrenci gönderimini geri verir.

turnIn

 Öğrenci gönderimini teslim eder.