Method: courses.courseWork.studentSubmissions.modifyAttachments

修改学生提交内容的附件。

只能向 workTypeASSIGNMENT 的课业对象的学生提交内容添加附件。

此请求必须由用于创建相应课业内容项的 OAuth 客户端 ID 的 Play 管理中心项目发出。

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

  • PERMISSION_DENIED:如果系统不允许请求访问的用户访问所请求的课程或课业,如果系统不允许请求访问的用户修改所请求的学生提交内容中的附件,或者如果出现访问错误
  • 如果请求格式不正确,则返回 INVALID_ARGUMENT
  • 如果请求的课程、课业或学生提交内容不存在,则为 NOT_FOUND

HTTP 请求

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

课程的标识符。此标识符可以是 Google 课堂分配的标识符,也可以是 alias

courseWorkId

string

课程作业的标识符。

id

string

学生提交内容的标识符。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "addAttachments": [
    {
      object (Attachment)
    }
  ],
  "previewVersion": enum (PreviewVersion)
}
字段
addAttachments[]

object (Attachment)

要添加的附件。学生提交的内容不得超过 20 个附件。

不支持 Form 附件。

previewVersion

enum (PreviewVersion)

可选。API 的预览版。必须设置此属性,才能使用预览版计划中向开发者提供的新 API 功能。

响应正文

如果成功,则响应正文包含一个 StudentSubmission 实例。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

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