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 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 (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üğe 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üğe 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

Bu gönderimin gecikip gecikmediği.

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 görebilir ve değiştirebilir.
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 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

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

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.

"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ı 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.

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

enum (CourseWorkType)

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

Salt okunur.
associatedWithDeveloper

boolean

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

Ayrıntılı bilgi için courseWork.create belgesine göz atın.

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

object (AssignmentSubmission)

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

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

object (ShortAnswerSubmission)

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

object (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

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ş bırakılırsa seviye seçilmedi demektir.
points

number

İ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 (Attachment)
    }
  ]
}
Alanlar
attachments[]

object (Attachment)

Öğ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 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
attachment alanı. 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

Öğrencinin kısa cevaplı bir soru için ç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ö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
type alanı. SubmissionHistory türü, StateHistory veya GradeHistory'den biri olabilir. type şunlardan yalnızca biri olabilir:
stateHistory

object (StateHistory)

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

object (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 (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Alanlar
state

enum (State)

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

string (Timestamp format)

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: "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, 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 (GradeChangeType)
}
Alanlar
pointsEarned

number

Gönderim not geçmişinde mevcut notun payıdır.
maxPoints

number

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

string (Timestamp format)

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: "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 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

get

 Öğrencinin gönderimini döndürür.

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

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

patch

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

reclaim

 Öğrencinin gönderdiği bir ödevi, sahibi olan öğrenci adına geri alır.

return

 Öğrencinin gönderimini döndürür.

turnIn

 Öğrencinin gönderdiği bir ödevi teslim eder.