Method: courses.courseWork.list

傳回要求者有權檢視的課程作業清單。

課程學生只能查看 PUBLISHED 項課程作業。課程老師和網域管理員可以查看所有課程作業，

這個方法會傳回下列錯誤代碼：

  • PERMISSION_DENIED如果要求的使用者無權存取要求的課程或發生存取錯誤存取錯誤。
  • 如果要求格式錯誤，則為 INVALID_ARGUMENT。
  • 如果要求的課程不存在，則為 NOT_FOUND。

HTTP 要求

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork

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

路徑參數

參數
courseId

string

課程的 ID。這個 ID 可以是 Classroom 指派的 ID，也可以是alias。

查詢參數

參數
courseWorkStates[]

enum (CourseWorkState)

對要傳回的工作狀態限制。只會傳回相符的課程作業。如未指定，系統會傳回工作狀態為 PUBLISHED 的項目。
orderBy

string

可選擇是否將結果排序。以半形逗號分隔的欄位清單，其中包含選用的排序方向關鍵字。支援的欄位為 updateTime 和 dueDate。支援的方向關鍵字為 asc 和 desc。如未指定，updateTime desc 為預設行為。範例：dueDate asc,updateTime desc、updateTime,dueDate desc
pageSize

integer

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

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

string

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

list 要求必須與導致這個權杖的要求相同，
previewVersion

enum (PreviewVersion)

選用設定。API 的預先發布版。完成這項設定後，才能存取搶先體驗方案為開發人員提供的全新 API 功能。

要求主體

要求主體必須為空白。

回應主體

列出課程作業時的回應。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "courseWork": [
    {
      object (CourseWork)
    }
  ],
  "nextPageToken": string
}
欄位
courseWork[]

object (CourseWork)

符合要求的課程作業項目。
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

詳情請參閱授權指南。