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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
courseId

string

課程的 ID。這個 ID 可以是 Classroom 指派的 ID 或 alias。
courseWorkId

string

要要求的學生作業的 ID。這可以設為字串常值 "-"，要求學生在指定課程中的所有課程作業。

查詢參數

參數
userId

string

選用引數，限制只能傳回學生擁有指定 ID 的學生作業。ID 可以是下列其中一項：

  • 使用者的數字 ID
  • 使用者的電子郵件地址
  • 字串常值 "me"，表示提出要求的使用者
states[]

enum (SubmissionState)

要求的提交狀態。如果有指定，發還的學生作業就會與其中一個指定的繳交狀態相符。
late

enum (LateValues)

要求的延遲值。如有指定，學生繳交的作業會受限於要求的值。如果未指定，則無論 late 值為何，系統都會傳回提交內容。
pageSize

integer

要傳回的項目數上限。0 或未指定時，表示伺服器可能會指派上限。

伺服器傳回的結果數量可能會少於指定數量。
pageToken

string

從先前的 list 呼叫傳回的 nextPageToken 值，表示應傳回後續頁面的結果。

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

退貨商品延遲值的限制。

列舉
LATE_VALUES_UNSPECIFIED 未指定提交遲交值的限制。
LATE_ONLY 如為遲交，則發還學生繳交的作業。
NOT_LATE_ONLY 發還學生繳交的作業 (遲交為 false)