您的用户是通过 Google Meet 使用 Google 课堂吗?请查看 Apps 脚本快速入门 - 了解如何在 Google Meet 课程中查看学生出席情况

Method: courses.courseWork.patch

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

更新课程作业的一个或多个字段。

如需详细了解哪些字段可能会更新以及哪些人可以更改这些字段,请参阅 google.classroom.v1.CourseWork

此请求必须通过用于创建相应课程工作项的 OAuth 客户端 ID 的开发者控制台项目发出。

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

  • 如果请求的开发者项目未创建相应的课程作业、用户无权对学生提交的作业做出所请求的修改,或出现访问错误,则为 PERMISSION_DENIED
  • 如果请求的格式错误,则返回 INVALID_ARGUMENT
  • 如果所请求的课程作业已被删除,则为 FAILED_PRECONDITION
  • NOT_FOUND(如果所请求的课程、课程作业或学生提交的作业不存在)。

HTTP 请求

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

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

id

string

课程作业的标识符。

查询参数

参数
updateMask

string (FieldMask format)

标识课程上哪些字段需要更新的掩码。必须填写此字段来执行更新。如果指定了无效字段,更新就会失败。如果某个字段支持空值,则可以通过在更新掩码中指定了相应值来清除它,而不是在 CourseWork 对象中清除。如果更新掩码中包含不支持空值的字段,并且未在 CourseWork 对象中设置该字段,则会返回 INVALID_ARGUMENT 错误。

以下字段可由教师指定:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId

这是一个以英文逗号分隔的完全限定字段名称列表。示例:"user.displayName,photo"

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 作用域:

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

有关详情,请参阅 OAuth 2.0 概览