REST Resource: courses.courseWork.studentSubmissions

Kaynak: StudentSubmission

Öğrencinin ders çalışması gönderimi.

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

Hiç erişilmeyen öğrenci gönderimlerinin (ör. state = NEW) oluşturulma veya güncellenme 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

Bunun 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önderilenler arasında benzersiz olmalıdır.

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.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat 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 ayar kaldırılabilir.

Salt okunur.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat 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 geç olup olmadığı

Salt okunur.
draftGrade

number

İsteğe bağlı olarak bekleyen not. Ayarlanmamışsa 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 bölümü yalnızca kurs öğretmenleri görebilir ve değiştirebilir.
assignedGrade

number

İsteğe bağlı not. Ayarlanmamışsa 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 kurs öğretmenleri tarafından değiştirilebilir.
rubricId

string

Yalnızca çıkış. Şu anda bu ders çalışmasına eklenmiş ve bu öğrenci gönderimini notlandırmak için kullanılan değerlendirme ölçeğinin tanımlayıcısı.

Rubrik yoksa bu kimlik boştur. Bu kimlik, şu anda etkin olan derecelendirme ölçeğini yansıtır. Öğretmenler derecelendirme ölçeğini 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 puan anahtarı notları bekleniyor.

Bu kurs çalışmasına puan anahtarı eklenmemişse veya puan anahtarı eklenmiş ancak herhangi bir ölçüt için not ayarlanmamışsa bu harita boştur. Girişler yalnızca belirlenen notlar için doldurulur. Anahtar: Rubriğin ö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ı atanır.

Bu kurs çalışmasına puan anahtarı eklenmemişse veya puan anahtarı eklenmiş ancak herhangi bir ölçüt için not ayarlanmamışsa bu harita boştur. Girişler yalnızca belirlenen notlar için doldurulur. Anahtar: Rubriğin ö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önderinin ait olduğu sınıf çalışması türü.

Salt okunur.
associatedWithDeveloper

boolean

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

Daha fazla ayrıntı 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ı'nda geliştiricilerin kullanımına sunulan yeni API özelliklerine erişmek için bu ayar yapılmalıdır.
Birleştirme alanı content. Gönderim içeriği. Belirli tür, course_work_type değerine bağlıdır. content yalnızca aşağıdakilerden biri olabilir:
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önderilen içerik.

RubricGrade

Öğrenci gönderimi için belirlenen değerlendirme ölçeği notu. Değerlendirme ölçeği ölçütü başına en fazla bir giriş olabilir.

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 düzey seçilmemiştir.
points

number

İsteğe bağlı. Bu ölçüt için atanan isteğe bağlı puanlar (genellikle seviyeye göre belirlenir). Seviyelerde puan olabilir veya olmayabilir. Ayarlanmamışsa bu ölçüt için puan belirlenmemiştir.

AssignmentSubmission

Bir ödevle ilgili öğ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 isteyen kullanıcının erişim izni varsa doldurulur. Identifier ve alternateLink alanları her zaman kullanılabilir ancak diğerleri (ör. başlık) kullanılamayabilir.

Ek

Öğrenci ödevine ek eklendi.

Ek oluştururken form alanını ayarlama 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 yalnızca aşağıdakilerden biri olabilir:
driveFile

object (DriveFile)

Google Drive dosyası eki.
youTubeVideo

object (YouTubeVideo)

YouTube video eki.
form

object (Form)

Google Formlar eki.

ShortAnswerSubmission

Kısa yanıtlı bir soruya verilen öğrenci yanıtı.

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

string

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

MultipleChoiceSubmission

Çoktan seçmeli bir soruya verilen öğrenci yanıtı.

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

string

Öğrencinin seçtiği seçenek.

SubmissionHistory

Gönderimin geçmişi. Şu anda eyalet ve sınıf geçmişleri bu kapsamdadır.

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. Type of SubmissionHistory, StateHistory veya GradeHistory olabilir. type yalnızca aşağıdakilerden biri olabilir:
stateHistory

object (StateHistory)

Gönderimin durum geçmişi bilgileri (varsa).
gradeHistory

object (GradeHistory)

Gönderimin not geçmişi bilgileri (varsa).

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 ne zaman geçtiği.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat 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önderimin 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ı (şablon olabilir veya olmayabilir) teslim etmiştir.
RETURNED Öğretmen, atanan belgeyi öğrenciye geri vermiştir.
RECLAIMED_BY_STUDENT Öğrenci, atanan belgeyi gönderdikten sonra ödevi "geri çekmeyi" seçti. Böylece, dosyanın sahibi olarak kontrolü tekrar öğrenciye geçti.
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 özelliği 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 sırada yer alan notun paydası.
gradeTimestamp

string (Timestamp format)

Gönderimin notu değiştirildiğinde

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat 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, bu sırada 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 yapılması
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Atanan notun payında değişiklik yapılması.
MAX_POINTS_CHANGE Notun paydasında değişiklik yapılması.

Yöntemler

get

 Bir öğrenci gönderimini döndürür.

list

 İstekte bulunan kullanıcının görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür. Bu işlemde isteğin OAuth kapsamları dikkate alınır.

modifyAttachments

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

patch

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

reclaim

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

return

 Bir öğrenci gönderimini döndürür.

turnIn

 Öğrenci gönderimini teslim eder.