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 כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
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)

אופציונלי. גרסת הטרום-השקה של ה-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.