Method: courses.announcements.addOnAttachments.create

在帖子下创建插件附件。

要求该插件有权在帖子中创建新附件。

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

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

HTTP 请求

POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

必需。课程的标识符。
itemId

string

要在其下创建附件的 Announcement、CourseWork 或 CourseWorkMaterial 的标识符。此字段是必填字段，但在从 postId 迁移期间未被标记为必填字段。

查询参数

参数
postId
(deprecated)

string

可选。已弃用，请改用 itemId。
addOnToken

string

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

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

若要在 Google 课堂中创建附件，则必须提供此授权令牌；若要先创建合作伙伴附件，则可以选择不提供此令牌。如果未在创建合作伙伴优先附件时提供，并且创建附件和其父级直播内容的开发者项目不匹配，则会返回错误。

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 范围：

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

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