您的用户是通过 Google Meet 使用 Google 课堂吗？请查看 Apps 脚本快速入门 - 了解如何在 Google Meet 课程中查看学生出席情况。

Method: courses.students.get

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

返回课程的学生。

此方法会返回以下错误代码：

  • PERMISSION_DENIED（如果请求用户无权查看此课程的学生或发生访问错误）。
  • 如果此课程没有任何学生具有请求的 ID，或者课程不存在，则为 NOT_FOUND。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

课程的标识符。此标识符可以是 Google 课堂分配的标识符，也可以是 alias。
userId

string

要返回的学生的标识符。该标识符可以是以下其中一项：

  • 用户的数字标识符
  • 用户的电子邮件地址
  • 字符串字面量 "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

有关详情，请参阅 OAuth 2.0 概览。