Method: courses.students.get

傳回課程的學生。

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

  • PERMISSION_DENIED (要求的使用者無法查看這門課程的學生) 或存取錯誤時。
  • 如果這門課程的學生沒有必要的 ID,或是課程不存在,則為 NOT_FOUND

HTTP 要求

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

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

路徑參數

參數
courseId

string

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

userId

string

要發還的學生 ID。ID 可以是下列其中一項:

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

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 Student 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.rosters.readonly
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

詳情請參閱授權指南