- משאב: הגשות לסטודנטים
- RubricGrade
- AssignmentSubmission
- קובץ מצורף
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- מדינה (State)
- GradeHistory
- GradeChangeType
- שיטות
משאב: הגשות לסטודנטים
הגשת עבודה של תלמיד/ה בקורס.
StudentSubmission
פריטים נוצרים כשפריט CourseWork
נוצר.
ייתכן שלא תהיה להם שעת יצירה או שעת עדכון להגשות של תלמידים שלא ניגשו אליהם בכלל (כלומר, עם state
= חדש).
ייצוג JSON |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
שדות | |
---|---|
courseId |
מזהה הקורס. קריאה בלבד. |
courseWorkId |
מזהה הקורס הרלוונטי. קריאה בלבד. |
id |
מזהה שהוקצה על ידי הכיתה להגשה של התלמיד/ה. הנתון הזה ייחודי מבין כל ההגשות בעבודה הרלוונטית בקורס. קריאה בלבד. |
userId |
המזהה של התלמיד/ה שהוא הבעלים של המטלה. קריאה בלבד. |
creationTime |
מועד היצירה של הטופס הזה אפשר לבטל את ההגדרה אם התלמיד/ה לא ניגש/ת לפריט. קריאה בלבד. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
updateTime |
מועד העדכון האחרון של הטופס הזה. אפשר לבטל את ההגדרה אם התלמיד/ה לא ניגש/ת לפריט. קריאה בלבד. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
state |
מצב השליחה. קריאה בלבד. |
late |
האם השליחה היא באיחור. קריאה בלבד. |
draftGrade |
ציון אופציונלי בהמתנה. אם המדיניות לא מוגדרת, לא הוגדר ציון. הערך הזה חייב להיות לא שלילי. מותר לציין ערכים עשרוניים (כלומר לא מספרים שלמים), אבל הם יעוגלו לשתי ספרות אחרי הנקודה העשרונית. רק מורים בקורס יכולים לשנות את ההגדרה הזו. |
assignedGrade |
ציון אופציונלי. אם המדיניות לא מוגדרת, לא הוגדר ציון. הערך הזה חייב להיות לא שלילי. מותר לציין ערכים עשרוניים (כלומר לא מספרים שלמים), אבל הם יעוגלו לשתי ספרות אחרי הנקודה העשרונית. רק מורים בקורס יכולים לשנות את ההגדרה הזו. |
rubricId |
פלט בלבד. מזהה של קריטריון ההערכה שמצורף כרגע לעבודה בקורס ומשמש למתן ציונים על ידי התלמיד או התלמידה. אם אין קריטריון הערכה, המזהה הזה ריק. המזהה הזה משקף את קריטריון ההערכה הפעיל; הוא משתנה אם המורים מוחקים את קריטריון ההערכה ויוצרים אותו מחדש. קריאה בלבד. |
draftRubricGrades |
ציונים בהמתנה לפי קריטריון הערכה על סמך הקריטריונים של קריטריון ההערכה. המפה הזו ריקה אם לא צירפת קריטריון הערכה לעבודת הקורס או אם יצורף קריטריון הערכה, אבל לא הוגדרו ציונים לפי קריטריונים כלשהם. הרשומות יאוכלסו רק עבור הציונים שהוגדרו. מפתח: מזהה הקריטריון של קריטריון ההערכה. קריאה בלבד. אובייקט שמכיל רשימה של |
assignedRubricGrades |
הוקצו ציונים לפי קריטריון הערכה על סמך הקריטריונים של קריטריון ההערכה. המפה הזו ריקה אם לא צורף קריטריון הערכה לעבודה הזו, או אם מצורף קריטריון הערכה, אבל לא הוגדרו ציונים לאף קריטריון. הרשומות יאוכלסו רק עבור הציונים שהוגדרו. מפתח: מזהה הקריטריון של קריטריון ההערכה. קריאה בלבד. אובייקט שמכיל רשימה של |
alternateLink |
קישור מוחלט להגשה בממשק המשתמש של Classroom באינטרנט. קריאה בלבד. |
courseWorkType |
סוג העבודה שעבורה מוגשת הבקשה. קריאה בלבד. |
associatedWithDeveloper |
האם ההגשה הזו של התלמיד/ה משויכת לפרויקט ב-Developer Console שעבורו נשלחה הבקשה. אתה יכול לראות עוד פרטים בכתובת קריאה בלבד. |
submissionHistory[] |
ההיסטוריה של ההגשה (כולל נתונים היסטוריים על המצב ועל ציונים). קריאה בלבד. |
previewVersion |
פלט בלבד. גרסת התצוגה המקדימה של ה-API. צריך להגדיר את האפשרות הזו כדי לקבל גישה ליכולות חדשות של API שזמינות למפתחים בתוכנית התצוגה המקדימה. |
שדה איחוד content . תוכן שנשלח. הסוג הספציפי תלוי בערך של course_work_type . content יכול להיות רק אחת מהאפשרויות הבאות: |
|
assignmentSubmission |
תוכן שנשלח כאשר הקורסWorkType הוא ASSIGNMENT. התלמידים יכולים לשנות את התוכן הזה באמצעות |
shortAnswerSubmission |
תוכן שמוגש כאשר הקורסWorkType הוא SHORT_ANSWER_QUESTION. |
multipleChoiceSubmission |
תוכן שנשלח כאשר aboutWorkType הוא 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
היסטוריית השליחה. בשלב הזה, המידע הזה כולל נתונים היסטוריים על מדינות (States) וציונים.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד type . סוג היסטוריית השליחה יכול להיות אחד מ-StateHistory, ציוןHistory. type יכול להיות רק אחת מהאפשרויות הבאות: |
|
stateHistory |
הפרטים על ההיסטוריה של מצב הקובץ, אם יש כאלה. |
gradeHistory |
הפרטים ההיסטוריים של הציונים בהגשה, אם יש כאלה. |
StateHistory
ההיסטוריה של כל מדינה שבה הייתה השליחה.
ייצוג JSON |
---|
{
"state": enum ( |
שדות | |
---|---|
state |
שלב צינור עיבוד הנתונים. |
stateTimestamp |
המועד שבו הפריט שנשלח עבר למצב הזה. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
actorUserId |
המורה או התלמיד/ה שביצעו את השינוי. |
מדינה
מדינות אפשריות שבהן אפשר יהיה לשלוח תוכן.
טיפוסים בני מנייה (enum) | |
---|---|
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 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
actorUserId |
המורה שביצע את השינוי בציון. |
gradeChangeType |
סוג השינוי בציונים בשלב הזה בהיסטוריית הציונים של ההגשה. |
GradeChangeType
סוגים אפשריים של שינוי ציונים.
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
לא צוין סוג של שינוי בציון. אין להחזיר ערך זה. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
שינוי במונה של טיוטת הציון. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
שינוי במונה של הציון שהוקצה. |
MAX_POINTS_CHANGE |
שינוי במכנה של הציון. |
שיטות |
|
---|---|
|
הפונקציה מחזירה את המטלה שהוגשה על ידי התלמיד/ה. |
|
הפונקציה מחזירה רשימת הגשות של תלמידים שמותר למגיש הבקשה להציג, תוך התייחסות להיקפי ההרשאות של OAuth של הבקשה. |
|
שינוי הקבצים המצורפים של הגשת התלמידים. |
|
עדכון שדה אחד או יותר בהגשה של התלמיד/ה. |
|
דרישה להגשה של תלמיד בשם התלמיד שהוא הבעלים של התוכן. |
|
הפונקציה מחזירה את המטלה שהוגשה על ידי התלמיד/ה. |
|
מגישה הגשה של תלמיד. |