Method: courses.posts.addOnAttachments.create

在帖子下创建插件附件。

插件必须拥有在帖子中创建新附件的权限。

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

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

HTTP 请求

POST https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

必需。课程的标识符。

postId
(deprecated)

string

可选。已弃用,请改用 itemId

查询参数

参数
itemId

string

要在其中创建连接的 AnnouncementCourseWorkCourseWorkMaterial 的标识符。此字段是必填字段,但在我们从 postId 迁移时,不会标记为此字段。

addOnToken

string

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

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

创建课堂内附件时需要此授权令牌,但在合作伙伴优先创建附件时,此授权令牌是可选的。如果创建合作伙伴优先连接时未提供,且创建连接的开发者项目与其父级信息流内容不匹配,则返回错误。

请求正文

请求正文包含一个 AddOnAttachment 实例。

响应正文

如果成功,响应正文将包含一个新创建的 AddOnAttachment 实例。

授权范围

需要以下 OAuth 范围:

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

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