在帖子下创建插件附件。
要求插件有权在帖子中创建新附件。
此方法会返回以下错误代码:
PERMISSION_DENIED
:访问错误。- 如果请求格式有误,则返回
INVALID_ARGUMENT
。 - 如果其中一个已标识的资源不存在,则为
NOT_FOUND
。
HTTP 请求
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
courseId |
必需。课程的标识符。 |
itemId |
用于创建附件的通知、courseWork 或 courseWorkMaterial 的标识符。此字段是必填字段,但在从 postId 迁移时未标记为必填字段。 |
查询参数
参数 | |
---|---|
postId |
可选。已弃用,请改用 itemId。 |
addOnToken |
可选。用于向请求授权的令牌。 当用户从 Google 课堂重定向到插件的网址时,系统会将令牌作为查询参数传递。 如要创建 Google 课堂附件,此授权令牌是必需的;但对于合作伙伴优先连接创建,则为可选令牌。如果未针对创建合作伙伴优先附件提供此通知,并且创建该附件的开发者项目与创建该附件的开发者项目不匹配,则会返回错误。 |
请求正文
请求正文包含一个 AddOnAttachment
实例。
响应正文
如果成功,响应正文将包含一个新创建的 AddOnAttachment
实例。
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/classroom.addons.teacher
有关详情,请参阅授权指南。