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

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

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