Method: courses.courseWork.getAddOnContext

获取特定帖子上下文中 Google 课堂插件的元数据。

为了保持自身数据和权限模型的完整性，每当插件在 iframe 中打开时，插件都应调用此方法来验证查询参数和发出请求的用户的角色。

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

  • PERMISSION_DENIED 表示访问错误。
  • 如果请求格式有误，则返回 INVALID_ARGUMENT。
  • 如果其中一个已标识的资源不存在，则返回 NOT_FOUND。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

必需。课程的标识符。
itemId

string

附件所附在的 Announcement、CourseWork 或 CourseWorkMaterial 的标识符。此字段是必填字段，但在我们从 postId 迁移时，不会标记为此字段。

查询参数

参数
addOnToken

string

可选。用于向请求授权的令牌。

当用户从 Google 课堂重定向到插件的网址时，令牌将作为查询参数传递。

如果满足下列任一条件，则需提供授权令牌：

  • 插件包含帖子中的附件。
  • 发出请求的开发者项目与创建帖子的项目相同。
attachmentId

string

可选。连接的标识符。除非用户在附件发现 iframe 中，否则所有请求都必须填写此字段。

请求正文

请求正文必须为空。

响应正文

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

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/classroom.addons.student
  • https://www.googleapis.com/auth/classroom.addons.teacher

有关详情，请参阅授权指南。