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.

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

פרמטרים
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 שזמינות למפתחים בתוכנית התצוגה המקדימה.

גוף הבקשה

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

גוף התשובה

תשובה בזמן הצגת המטלות של התלמידים.

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

ייצוג 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 החזר הגשות לתלמידים אם מועד העיכוב נכון.
NOT_LATE_ONLY החזר הגשות לתלמידים אם איחור בהגשה לא נכון.