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

要在其下创建附件的 AnnouncementCourseWorkCourseWorkMaterial 的标识符。此字段是必填字段,但在从 postId 迁移期间未被标记为必填字段。

查询参数

参数
postId
(deprecated)

string

可选。已弃用,请改用 itemId

addOnToken

string

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

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

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

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 范围:

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

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