- משאב: מטלות תלמידים
- RubricGrade
- AssignmentSubmission
- קובץ מצורף
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- מדינה
- GradeHistory
- GradeChangeType
- שיטות
משאב: מטלות לתלמידים
הגשת התלמיד על העבודות בקורס.
StudentSubmission
פריטים נוצרים בעת יצירת פריט CourseWork
.
לא ניתן להגדיר שעת יצירה או שעת עדכון להגשות של תלמידים שמעולם לא ניגשו אליהן (כלומר, עם state
= חדש).
ייצוג JSON |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
שדות | |
---|---|
courseId |
מזהה הקורס. קריאה בלבד. |
courseWorkId |
המזהה של העבודה שקשורה לקורס הזה. קריאה בלבד. |
id |
מזהה שהוקצה ל-Classroom להגשה של התלמיד/ה. ההבדל הזה ייחודי בין הגשות עבור העבודה הרלוונטית בקורס. קריאה בלבד. |
userId |
המזהה של התלמיד/ה שהוא הבעלים של הטופס הזה. קריאה בלבד. |
creationTime |
מועד היצירה של הקובץ המצורף. אם התלמיד/ה לא ניגש/ה לפריט הזה, אפשר לבטל את ההגדרה שלו. קריאה בלבד. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
updateTime |
מועד העדכון האחרון של הבקשה הזו. אם התלמיד/ה לא ניגש/ה לפריט הזה, אפשר לבטל את ההגדרה שלו. קריאה בלבד. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
state |
מצב השליחה. קריאה בלבד. |
late |
האם השליחה מתעכבת. קריאה בלבד. |
draftGrade |
אופציונלי בהמתנה לציון. אם המדיניות לא מוגדרת, לא הוגדר ציון. הערך הזה לא יכול להיות שלילי. מותר להשתמש בערכים עשרוניים (כלומר, לא מספרים שלמים), אבל הם יעוגלו לשתי ספרות אחרי הנקודה העשרונית. רק מורים של הקורס יכולים לראות ולשנות אותו. |
assignedGrade |
ציון אופציונלי. אם המדיניות לא מוגדרת, לא הוגדר ציון. הערך הזה לא יכול להיות שלילי. מותר להשתמש בערכים עשרוניים (כלומר, לא מספרים שלמים), אבל הם יעוגלו לשתי ספרות אחרי הנקודה העשרונית. רק מורים של הקורס יכולים לשנות את ההגדרה הזו. |
rubricId |
פלט בלבד. מזהה קריטריון ההערכה שמצורף כרגע לעבודה בקורס הזה ומשמש למתן ציונים להגשה על ידי התלמיד/ה. אם אין קריטריון להערכה, המזהה הזה ריק. המזהה משקף את קריטריון ההערכה הפעיל כרגע. הוא משתנה אם המורים מוחקים את קריטריון ההערכה ויוצרים אותו מחדש. קריאה בלבד. |
draftRubricGrades |
ציונים בהמתנה לקריטריוני הערכה על סמך הקריטריונים של קריטריון ההערכה. המפה הזו ריקה אם לא מצורפת קריטריון הערכה לעבודה הזו בקורס, או אם מצורפת קריטריון הערכה, אבל לא הוגדרו ציונים לאף קריטריונים. הערכים מאוכלסים רק עבור ציונים שהוגדרו. מפתח: מזהה הקריטריון של קריטריון ההערכה. קריאה בלבד. אובייקט שמכיל רשימה של |
assignedRubricGrades |
מקצים ציונים לקריטריון הערכה על סמך קריטריונים של קריטריון הערכה. המפה הזו ריקה אם לא מצורפת קריטריון הערכה לעבודה הזו בקורס, או אם מצורפת קריטריון הערכה, אבל לא הוגדרו ציונים באף קריטריון. הערכים מאוכלסים רק עבור ציונים שהוגדרו. מפתח: מזהה הקריטריון של קריטריון ההערכה. קריאה בלבד. אובייקט שמכיל רשימה של |
alternateLink |
קישור מוחלט להגשה בממשק המשתמש של Classroom באינטרנט. קריאה בלבד. |
courseWorkType |
סוג העבודה שאליה מיועדת ההגשה הזו. קריאה בלבד. |
associatedWithDeveloper |
האם ההגשה הזו של התלמיד משויכת לפרויקט ב-Play Console שהגיש את הבקשה. פרטים נוספים זמינים בכתובת קריאה בלבד. |
submissionHistory[] |
היסטוריית ההגשות (כולל היסטוריה ברמת המדינה והציון). קריאה בלבד. |
previewVersion |
פלט בלבד. גרסת התצוגה המקדימה של ה-API. יש להגדיר זאת כדי לגשת ליכולות API חדשות שזמינות למפתחים בתוכנית התצוגה המקדימה. |
שדה איחוד content . התוכן שנשלח. הסוג הספציפי תלוי בערך של course_work_type . הערך של content יכול להיות רק אחת מהאפשרויות הבאות: |
|
assignmentSubmission |
שליחת תוכן כש-courseWorkType הוא בוחן. התלמידים יכולים לשנות את התוכן הזה באמצעות |
shortAnswerSubmission |
תוכן שליחת התוכן כאשר classWorkType הוא SHORT_ANSWER_QUESTION. |
multipleChoiceSubmission |
שליחת התוכן כאשר הערך של classWorkType הוא MULTIPLE_CHOICE_QUESTION. |
RubricGrade
קריטריון הערכה שהוגדר להגשה על ידי התלמיד. לכל קריטריון של קריטריון הערכה קיימת רק רשומה אחת.
ייצוג JSON |
---|
{ "criterionId": string, "levelId": string, "points": number } |
שדות | |
---|---|
criterionId |
אפשרות. מזהה הקריטריון. |
levelId |
אפשרות. מזהה הרמה האופציונלי של הרמה שנבחרה. אם השדה ריק, לא נבחרה רמה. |
points |
אפשרות. נקודות אופציונליות שהוקצו לקריטריון זה, בדרך כלל המבוססות על הרמה. רמות יכולות להכיל נקודות, אבל לא בהכרח. אם הקריטריון לא מוגדר, לא הוגדרו נקודות. |
AssignmentSubmission
עבודות של תלמידים למטלה.
ייצוג JSON |
---|
{
"attachments": [
{
object ( |
שדות | |
---|---|
attachments[] |
קבצים שהתלמיד הוסיף. אם התלמיד/ה לא ניגש/ה למטלה ב-Classroom, ייתכן שקובצי Drive שתואמים לחומרים עם מצב שיתוף של STUDENT_COPY עדיין לא קיימים. חלק מהמטא-נתונים של הקבצים המצורפים מאוכלסים רק אם למשתמש ששלח את הבקשה יש הרשאה לגשת אליהם. השדות 'מזהה' ו'קישור חלופי' תמיד זמינים, אבל אחרים (למשל title) לא יכולים להיות זמינים. |
קובץ מצורף
הקובץ צורף לעבודה של התלמידים.
כשיוצרים קבצים מצורפים, אין תמיכה בהגדרת השדה form
.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד attachment . נתונים של קבצים מצורפים. הערך של attachment יכול להיות רק אחת מהאפשרויות הבאות: |
|
driveFile |
קובץ מצורף מ-Google Drive. |
youTubeVideo |
קובץ מצורף של סרטון ב-YouTube. |
link |
קובץ קישור מצורף. |
form |
קובץ מצורף מ-Google Forms. |
ShortAnswerSubmission
עבודה של תלמיד ותלמידה על שאלה שיש בה תשובה קצרה.
ייצוג JSON |
---|
{ "answer": string } |
שדות | |
---|---|
answer |
תשובה של התלמיד/ה לשאלה קצרה. |
MultipleChoiceSubmission
עבודה של תלמיד/ה עם שאלה אמריקאית.
ייצוג JSON |
---|
{ "answer": string } |
שדות | |
---|---|
answer |
הבחירה של התלמיד/ה. |
SubmissionHistory
היסטוריית ההגשות. נכון לעכשיו, ההיסטוריה כוללת את המדינה והרמות.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד type . סוג היסטוריית ההגשות, יכול להיות אחד מהיסטוריית המדינה, היסטוריית הציונים. הערך של type יכול להיות רק אחת מהאפשרויות הבאות: |
|
stateHistory |
פרטי היסטוריית המדינה של הבקשה, אם קיימים. |
gradeHistory |
פרטי היסטוריית הציונים של ההגשה, אם יש כאלה. |
StateHistory
ההיסטוריה של כל מדינה שבה נשלח התוכן הזה.
ייצוג JSON |
---|
{
"state": enum ( |
שדות | |
---|---|
state |
שלב צינור העבודה של תהליך העבודה. |
stateTimestamp |
מתי השליחה עברה למצב הזה. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
actorUserId |
המורה או התלמיד/ה שביצעו את השינוי. |
ארץ
מצבים אפשריים שבהם ניתן יהיה להגיש את הפרויקט.
טיפוסים בני מנייה (enums) | |
---|---|
STATE_UNSPECIFIED |
לא צוינה מדינה. אין להחזיר את המצב הזה אף פעם. |
CREATED |
הפריט שנשלח נוצר. |
TURNED_IN |
התלמיד או התלמידה הגיש/ה מסמך שהונפק, ויכול להיות שהוא לא תבנית. |
RETURNED |
המורה החזיר לתלמיד/ה את המסמך שהוקצה לו. |
RECLAIMED_BY_STUDENT |
התלמיד/ה הגיש/ה את המסמך שהוקצה ולאחר מכן בחר/ה 'לבטל את ההגשה' של המטלה. במילים אחרות, השליטה שוב בבעלות התלמידים. |
STUDENT_EDITED_AFTER_TURN_IN |
התלמיד או התלמידה ערך/ה את המטלה אחרי שהוגשה. בשלב הזה, נעשה שימוש רק בקטע 'שאלות' כשהתלמיד או תלמידה עורכים את התשובה שלהם. |
GradeHistory
ההיסטוריה של כל ציון בהגשה הזו.
ייצוג JSON |
---|
{
"pointsEarned": number,
"maxPoints": number,
"gradeTimestamp": string,
"actorUserId": string,
"gradeChangeType": enum ( |
שדות | |
---|---|
pointsEarned |
המונה של הציון בשלב זה בהיסטוריית הציונים בהגשה. |
maxPoints |
המכנה של הציון בשלב זה בהיסטוריית הציונים של ההגשה. |
gradeTimestamp |
תאריך השינוי של ציון ההגשה. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
actorUserId |
המורה שביצע את שינוי הציון. |
gradeChangeType |
סוג שינוי הציון בשלב זה בהיסטוריית הציונים של ההגשה. |
GradeChangeType
סוגים אפשריים של שינוי ציונים.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
לא צוין סוג של שינוי ציון. אין להחזיר את המצב הזה אף פעם. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
שינוי במונה של טיוטת הציון. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
שינוי במונה של הציון שניתן. |
MAX_POINTS_CHANGE |
שינוי במכנה של הציון. |
שיטות |
|
---|---|
|
מחזירה הגשה של תלמיד. |
|
מחזירה רשימה של הגשות תלמידים שהמגיש רשאי לצפות בהן, תוך התייחסות להיקפי OAuth של הבקשה. |
|
עריכת הקבצים המצורפים של התלמיד או התלמידה. |
|
עדכון שדה אחד או יותר בהגשה של התלמיד או התלמידה. |
|
החזרת הגשה לתלמיד/ה בשם התלמיד/ה שבבעלותו. |
|
מחזירה הגשה של תלמיד. |
|
מגיש את הקובץ של התלמיד או התלמידה. |