Method: courses.courseWork.studentSubmissions.list

הפונקציה מחזירה רשימה של מטלות של תלמידים שהמגיש רשאי להציג, בהתאם להיקפי ה-OAuth של הבקשה. אפשר לציין את - כ-courseWorkId כדי לכלול את הגשות התלמידים לכמה פריטים של עבודות בקורס.

תלמידים יכולים לראות רק את העבודות שלהם. מורים בקורס ואדמינים בדומיין יכולים לראות את כל העבודות שהתלמידים הגישו.

השיטה הזו מחזירה את קודי השגיאה הבאים:

  • PERMISSION_DENIED אם למשתמש המבקש אין הרשאה לגשת לקורס או למטלה המבוקשים, או בגלל שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • NOT_FOUND אם הקורס המבוקש לא קיים.

בקשת HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
courseId

string

המזהה של הקורס. המזהה הזה יכול להיות המזהה שהוקצה ב-Classroom או alias.
courseWorkId

string

המזהה של עבודת התלמיד/ה שרוצים לבקש. אפשר להגדיר את הערך הזה למחרוזת "-" כדי לבקש עבודות של תלמידים מכל העבודות בקורס שצוין.

פרמטרים של שאילתה

פרמטרים
userId

string

ארגומנט אופציונלי להגבלת העבודות שהוחזרו לתלמידים לעבודות שבבעלות התלמיד/ה עם המזהה שצוין. המזהה יכול להיות אחד מהערכים הבאים:

  • המזהה המספרי של המשתמש
  • כתובת האימייל של המשתמש
  • מחרוזת הליבה "me", שמציינת את המשתמש ששלח את הבקשה
states[]

enum (SubmissionState)

מצבי ההגשה המבוקשים. אם צוין, עבודות שהתלמידים החזירו יהיו תואמות לאחת מהמצבויות של הגשות שצוינו.
late

enum (LateValues)

ערך העיכוב המבוקש. אם מציינים ערך, עבודות שהתלמידים החזירו מוגבלות לפי הערך המבוקש. אם לא צוין ערך, ההגשות יחזרו ללא קשר לערך של late.
pageSize

integer

מספר הפריטים המקסימלי להחזרה. אפס או ערך לא מצוין מצביעים על כך שהשרת עשוי להקצות ערך מקסימלי.

יכול להיות שהשרת יחזיר פחות מהמספר שצוין של תוצאות.
pageToken

string

הערך nextPageToken שהוחזר מקריאה קודמת של list, ומציין שצריך להחזיר את דף התוצאות הבא.

הבקשה list חייבת להיות זהה לזו שהובילה ליצירת האסימון הזה, בכל שאר הפרטים.
previewVersion

enum (PreviewVersion)

זה שינוי אופציונלי. גרסת ה-Preview של ה-API. צריך להגדיר את ההגדרה הזו כדי לגשת ליכולות API חדשות שזמינות למפתחים בתוכנית ה-Preview.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

התגובה שמוצגת כשמציגים את המטלות של התלמידים.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
שדות
studentSubmissions[]

object (StudentSubmission)

עבודות של תלמידים שתואמות לבקשה.
nextPageToken

string

אסימון שמזהה את דף התוצאות הבא להצגה. אם השדה ריק, אין תוצאות נוספות.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

מידע נוסף זמין במדריך ההרשאות.

LateValues

הגבלות על הערך של פריטים שהוחזרו באיחור.

טיפוסים בני מנייה (enum)
LATE_VALUES_UNSPECIFIED לא צוינה הגבלה על ערכים של שליחת דיווחים באיחור.
LATE_ONLY הפונקציה מחזירה את הערך StudentSubmissions כאשר הערך late הוא True.
NOT_LATE_ONLY הפונקציה מחזירה את הערך StudentSubmissions כאשר הערך של late הוא false.