- בקשת 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
הגבלות על הערך המאוחר של פריטים שהוחזרו.
טיפוסים בני מנייה (enums) | |
---|---|
LATE_VALUES_UNSPECIFIED |
לא צוינו ערכים מאוחרים של הגשה. |
LATE_ONLY |
החזר מטלות שהוגשו עבור תלמידים כאשר תאריך ההגשה הוא נכון. |
NOT_LATE_ONLY |
החזרת מטלות שהוגשו לתלמידים אם תאריך היעד שגוי הוא false. |