REST Resource: courses.courseWork.studentSubmissions

Kaynak: Öğrenci Gönderimi

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

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

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

  // 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

Dersin tanımlayıcısıdır.

Salt okunur.
courseWorkId

string

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

Salt okunur.
id

string

Öğrenci gönderimi için Classroom tarafından atanan tanımlayıcı. Bu, ilgili kurs çalışmasıyla ilgili gönderimler arasında benzersiz olmalıdır.

Salt okunur.
userId

string

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

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 sahip ve en fazla dokuz kesirli basamak içeren 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 sahip ve en fazla dokuz kesirli basamak içeren 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ı bekleyen not. Ayarlanmamışsa not ayarlanmamıştır. Bu değer, negatif olmayan bir sayı olmalıdır. Ondalık (yani tam sayı olmayan) değerlere izin verilir ancak iki ondalık basamağa yuvarlanır.

Bu bölüm yalnızca kurs öğretmenleri tarafından görülebilir ve değiştirilebilir.
assignedGrade

number

İsteğe bağlı not. Ayarlanmamışsa not ayarlanmamıştır. Bu değer, negatif olmayan bir sayı olmalıdır. Ondalık (yani tam sayı olmayan) değerlere izin verilir ancak 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 kurs çalışmasına eklenmiş olan ve bu öğrenci gönderimini notlandırmak için kullanılan değerlendirme ölçeğinin tanımlayıcısıdır.

Ölçüm yok ise bu kimlik boştur. Bu kimlik, şu anda etkin olan notlandırmayı yansıtır. Öğretmenler notlandırmayı 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ı beklemede.

Bu kurs çalışmasına eklenmiş bir değerlendirme ölçeği yoksa veya bir değerlendirme ölçeği eklenmişse ancak herhangi bir ölçüt için not ayarlanmamışsa bu harita boş olur. Girişler yalnızca ayarlanmış notlar için doldurulur. Anahtar: Ölçeğ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 atanan puan anahtarı notları.

Bu kurs çalışmasına değerlendirme ölçeği eklenmemişse veya eklenmişse ancak herhangi bir ölçüt için not ayarlanmamışsa bu harita boş olur. Girişler yalnızca ayarlanmış notlar için doldurulur. Anahtar: Ölçeğ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 hangi sınıf çalışmasına ait olduğunu belirtir.

Salt okunur.
associatedWithDeveloper

boolean

Bu öğrenci gönderiminin, isteği yapan 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ında geliştiricilere sunulan yeni API özelliklerine erişmek için bu ayar yapılmalıdır.
Birlik alanı content. Gönderilen içerik. Belirli tür, course_work_type değerine bağlıdır. content yalnızca aşağıdakilerden biri olabilir:
assignmentSubmission

object (AssignmentSubmission)

courseWorkType özelliği 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.

RubricGrade

Öğrenci gönderimi için ayarlanan bir değerlendirme notu. Değerlendirme ölçeği ö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 düzeyin isteğe bağlı düzey kimliği. Boşsa hiçbir düzey seçilmemiştir.
points

number

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

AssignmentSubmission

Ö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 STUDENT_COPY paylaşım moduna sahip materyallere karşılık gelen Drive dosyaları henüz mevcut olmayabilir.

Bazı ek meta verileri yalnızca istek gönderen kullanıcının erişme izni varsa doldurulur. Tanımlayıcı ve alternatifBağlantı alanları her zaman kullanılabilir ancak diğerleri (ör. başlık) kullanılamayabilir.

Ek

Öğrencinin ödev çalışmasına ek 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 yalnızca aşağıdakilerden biri olabilir:
driveFile

object (DriveFile)

Google Drive dosyası eki.
youTubeVideo

object (YouTubeVideo)

YouTube videosu eki.
form

object (Form)

Google Formlar eki.

ShortAnswerSubmission

Kısa yanıtlı bir soruya ait öğ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 bir soruya ait öğrenci çalışması.

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

string

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

SubmissionHistory

Gönderimin geçmişi. Şu anda durum ve not geçmişleri 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 veya GradeHistory değerlerinden biri olabilir. type yalnızca aşağıdakilerden biri olabilir:
stateHistory

object (StateHistory)

Varsa gönderimin durum geçmişi bilgileri.
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üzen aşaması.
stateTimestamp

string (Timestamp format)

Gönderimin bu duruma ne zaman girdiği.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren 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önderimin 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, atanmış dokümanı öğrenciye geri vermiştir.
RECLAIMED_BY_STUDENT Öğrenci, atanmış dokümanı teslim ettikten sonra ödevin "gönderimini iptal etmeyi" seçti. Böylece öğrenci, sahip olarak tekrar kontrol sahibi oldu.
STUDENT_EDITED_AFTER_TURN_IN Öğrenci, gönderdiği gönderimi düzenledi. Şu anda yalnızca öğrenciler yanıtlarını düzenlerken 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 anda notun payı.
maxPoints

number

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

string (Timestamp format)

Gönderilen çalışmanın notu değiştiğinde.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren 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 notu geçmişinde şu anda bulunan 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 değer hiçbir zaman döndürülmemelidir.
DRAFT_GRADE_POINTS_EARNED_CHANGE Taslak notun paydasında yapılan bir değişiklik.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Atanan notun paydasında değişiklik.
MAX_POINTS_CHANGE Notun paydasında değişiklik.

Yöntemler

get

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

list

 İsteğin OAuth kapsamlarını dikkate alarak, istek sahibinin görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür.

modifyAttachments

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

patch

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

reclaim

 Gönderimin sahibi olan öğrenci adına öğrenci gönderimini yeniden talep eder.

return

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

turnIn

 Öğrenci gönderimi teslim eder.