Method: courses.get

返回课程。

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

  • 如果请求用户无权访问所请求的课程或存在 访问错误，则返回 PERMISSION_DENIED。
  • 如果不存在具有所请求 ID 的课程，则返回 NOT_FOUND。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
id

string

要返回的课程的标识符。此标识符可以是 Classroom 分配的标识符，也可以是 alias。

查询参数

参数
previewVersion

enum (PreviewVersion)

可选。API 的预览版。必须设置此参数，才能访问在试用计划中向开发者提供的新 API 功能。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 Course 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly

如需了解详情，请参阅授权指南。