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

附件所附在的 AnnouncementCourseWorkCourseWorkMaterial 的标识符。此字段是必填字段,但在我们从 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

有关详情,请参阅授权指南