傳回要求者允許查看的學生繳交內容清單,並將要求的 OAuth 範圍納入考量。可以將 -
指定為 courseWorkId
,以便加入學生的多個課程作業項目。
課程學生只能查看自己的作業。課程老師和網域管理員可以查看所有學生繳交的作業。
這個方法會傳回下列錯誤代碼:
PERMISSION_DENIED
:要求的使用者無法存取要求的課程或課程作業,或是存取錯誤。- 如果要求格式錯誤,則為
INVALID_ARGUMENT
。 - 如果要求的課程不存在,則為
NOT_FOUND
。
HTTP 要求
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
courseId |
課程的 ID。這個 ID 可以是 Classroom 指派的 ID,也可以是 |
courseWorkId |
所要要求學生作業的 ID。此值可設為字串常值 |
查詢參數
參數 | |
---|---|
userId |
選用引數,可以限制只將學生擁有指定 ID 的作業發還給學生。ID 可以是下列其中一項:
|
states[] |
要求的提交狀態。如有指定,系統會將學生繳交的作業與任一指定繳交狀態相符。 |
late |
要求的延遲時間值。如果有指定,系統就會根據要求的值限制學生繳交的作業。如未指定,無論 |
pageSize |
傳回的項目數量上限。0 或未指定值表示伺服器可能會指派上限。 伺服器傳回的結果數量可能會少於指定數量。 |
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
對傳回項目的延遲值限制。
列舉 | |
---|---|
LATE_VALUES_UNSPECIFIED |
未指定遲交的值限制。 |
LATE_ONLY |
不遲交作業的「學生繳交的作業」。 |
NOT_LATE_ONLY |
遲交時為 false 的「學生繳交的作業」。 |