- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- LateValues
- רוצים לנסות?
הפונקציה מחזירה רשימת הגשות של תלמידים שמותר למגיש הבקשה להציג, תוך התייחסות להיקפי ההרשאות של OAuth של הבקשה. אפשר לציין את -
בתור courseWorkId
כדי לכלול הגשות של תלמידים עבור מספר פריטי עבודה בקורס.
תלמידי הקורס יכולים לצפות רק בעבודות שלהם. מורים לקורס ומנהלי דומיינים יכולים לראות את כל המטלות שהתלמידים הגישו.
השיטה הזו מחזירה את קודי השגיאה הבאים:
PERMISSION_DENIED
אם המשתמש ששלח את הבקשה לא מורשה לגשת לקורס או לעבודה המבוקשת, או אם יש שגיאות גישה.INVALID_ARGUMENT
אם הבקשה בפורמט שגוי.NOT_FOUND
אם הקורס המבוקש לא קיים.
בקשת HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
courseId |
מזהה הקורס. המזהה הזה יכול להיות המזהה שהוקצה על ידי Classroom או |
courseWorkId |
המזהה של העבודה של התלמיד/ה לבקשה. אפשר להגדיר את זה בתור ליטרל מחרוזת |
פרמטרים של שאילתה
פרמטרים | |
---|---|
userId |
ארגומנט אופציונלי להגבלת העבודות שהוחזרו לתלמידים עם המזהה שצוין. המזהה יכול להיות אחד מהבאים:
|
states[] |
מצבי השליחה המבוקשים. אם צוין, המטלות שהוחזרו לתלמידים תואמות לאחד ממצבי ההגשה שצוינו. |
late |
ערך האיחור המבוקש. אם צוין, הערך המבוקש מגביל את ההגשות של התלמידים שהוחזרו. אם לא צוין אחרת, ההגשות יוחזרו ללא קשר לערך של |
pageSize |
מספר הפריטים המקסימלי שיוחזרו. הערך 'אפס' או 'לא מוגדר' מציין שהשרת עשוי להקצות מקסימום. השרת עשוי להחזיר פחות ממספר התוצאות שצוין. |
pageToken |
הערך של הבקשה של |
previewVersion |
זה שינוי אופציונלי. גרסת התצוגה המקדימה של ה-API. צריך להגדיר את האפשרות הזו כדי לקבל גישה ליכולות חדשות של API שזמינות למפתחים בתוכנית התצוגה המקדימה. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תשובה בזמן הצגת המטלות של התלמידים.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"studentSubmissions": [
{
object ( |
שדות | |
---|---|
studentSubmissions[] |
עבודות של תלמידים שתואמות לבקשה. |
nextPageToken |
אסימון המזהה את דף התוצאות הבא שיש להחזיר. אם השדה ריק, אין תוצאות נוספות. |
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של 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 |
החזר הגשות לתלמידים אם איחור בהגשה לא נכון. |