- Kaynak: Öğrenci Gönderimi
- RubricGrade
- AssignmentSubmission
- Ek
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- Durum
- GradeHistory
- GradeChangeType
- Yöntemler
Kaynak: StudentSubmission
Öğrencinin kurs çalışması gönderimi.
CourseWork
öğesi oluşturulduğunda StudentSubmission
öğeleri oluşturulur.
Hiç erişilmemiş öğrenci gönderimlerinin (ör. state
= YENİ) oluşturulma veya güncellenme zamanı olmayabilir.
JSON gösterimi |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
Alanlar | |
---|---|
courseId |
Dersin tanımlayıcısıdır. Salt okunur. |
courseWorkId |
Bu sınıf çalışmasına karşılık gelen tanımlayıcı. Salt okunur. |
id |
Öğrenci gönderimi için Classroom tarafından atanan tanımlayıcı. Bu, ilgili ders çalışması için gönderilenler arasında benzersiz olmalıdır. Salt okunur. |
userId |
Bu gönderimin sahibi olan öğrencinin tanımlayıcısıdır. Salt okunur. |
creationTime |
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: |
updateTime |
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: |
state |
Bu gönderimin durumu. Salt okunur. |
late |
Bu gönderimin gecikip gecikmediği. Salt okunur. |
draftGrade |
İ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 düzenlenebilir. |
assignedGrade |
İ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 |
Yalnızca çıkış. Şu anda bu kurs çalışmasına eklenmiş olan ve bu öğrenci gönderimine not vermek için kullanılan değerlendirme ölçeğinin tanımlayıcısıdır. Ölçüt yoksa 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 |
Puan anahtarının ölçütlerine göre bekleyen puan anahtarı notları. Bu kurs çalışmasına eklenmiş bir değerlendirme ölçeği yoksa veya eklenmiş bir değerlendirme ölçeği varsa 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.
|
assignedRubricGrades |
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.
|
alternateLink |
Classroom web kullanıcı arayüzündeki gönderimin mutlak bağlantısı. Salt okunur. |
courseWorkType |
Bu gönderinin hangi sınıf çalışmasına ait olduğunu belirtir. Salt okunur. |
associatedWithDeveloper |
Bu öğrenci gönderiminin, isteği yapan Developer Console projesiyle ilişkili olup olmadığı. Daha fazla bilgi için Salt okunur. |
submissionHistory[] |
Gönderimin geçmişi (durum ve not geçmişlerini içerir). Salt okunur. |
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 |
courseWorkType özelliği ASSIGNMENT olduğunda gönderim içeriği. Öğrenciler |
shortAnswerSubmission |
courseWorkType SHORT_ANSWER_QUESTION olduğunda gönderim içeriği. |
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 |
İsteğe bağlı. Ölçüt kimliği. |
levelId |
İ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 |
İ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 ( |
Alanlar | |
---|---|
attachments[] |
Öğ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 |
Alanlar | |
---|---|
Birlik alanı attachment . Ek verileri. attachment yalnızca aşağıdakilerden biri olabilir: |
|
driveFile |
Google Drive dosyası eki. |
youTubeVideo |
YouTube videosu eki. |
link |
Ek bağlantısı. |
form |
Google Formlar eki. |
ShortAnswerSubmission
Kısa yanıtlı bir soruya ait öğrenci çalışması.
JSON gösterimi |
---|
{ "answer": string } |
Alanlar | |
---|---|
answer |
Öğ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 |
Öğ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 |
Alanlar | |
---|---|
Birlik alanı type . SubmissionHistory türü, StateHistory veya GradeHistory değerlerinden biri olabilir. type yalnızca aşağıdakilerden biri olabilir: |
|
stateHistory |
Varsa gönderimin durum geçmişi bilgileri. |
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 ( |
Alanlar | |
---|---|
state |
İş akışı ardışık düzen aşaması. |
stateTimestamp |
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: |
actorUserId |
Değişikliği yapan öğretmen veya öğrenci. |
Eyalet
Gönderimlerin 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 ödevi "göndermeyi 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 ( |
Alanlar | |
---|---|
pointsEarned |
Gönderim notu geçmişinde bu anda notun payı. |
maxPoints |
Gönderim notu geçmişinde bu anda notun payı. |
gradeTimestamp |
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: |
actorUserId |
Not değişikliğini yapan öğretmen. |
gradeChangeType |
Gönderim notu geçmişinde şu anda geçerli olan 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 |
|
---|---|
|
Bir öğrenci gönderimini döndürür. |
|
İsteğin OAuth kapsamlarını dikkate alarak, istek sahibinin görüntülemesine izin verilen öğrenci gönderimlerinin listesini döndürür. |
|
Öğrenci gönderimlerinin eklerinde değişiklik yapar. |
|
Bir öğrenci gönderimindeki bir veya daha fazla alanı günceller. |
|
Bir öğrenci gönderimini, gönderimin sahibi olan öğrenci adına yeniden talep eder. |
|
Bir öğrenci gönderimini döndürür. |
|
Öğrenci gönderimi teslim eder. |