Method: courses.updateGradingPeriodSettings

更新课程的评分周期设置。

您可以使用此方法添加、移除或修改单个评分周期。

发出请求的用户和课程所有者必须有权修改评分周期。如需了解详情，请参阅许可要求。

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

  • PERMISSION_DENIED 如果系统不允许请求用户修改课程的评分周期设置，或者因访问权限错误而导致：
    • UserIneligibleToUpdateGradingPeriodSettings
  • 如果请求格式不正确，则返回 INVALID_ARGUMENT。
  • 如果请求的课程不存在，则返回 NOT_FOUND。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

必需。课程的标识符。

查询参数

参数
updateMask

string (FieldMask format)

用于标识要更新 GradingPeriodSettings 中的哪些字段的掩码。

GradingPeriodSettings gradingPeriods 列表将被更新请求中指定的评分周期完全替换。例如：

  • 如果列表中包含没有 ID 的评分周期，则会被视为新添加的评分周期，系统会在您提出请求时为其分配新的 ID。
  • 目前存在但在请求中缺少的评分周期将被视为已删除。
  • 评分周期如果使用现有 ID 且数据已修改，则会被视为修改。未修改的数据将保持不变。
  • 如果包含未知 ID 的评分周期，则会导致错误。

可指定以下字段：

  • gradingPeriods
  • applyToExistingCoursework

这是完全限定字段名称的逗号分隔列表。示例："user.displayName,photo"。
previewVersion

enum (PreviewVersion)

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

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/classroom.courses

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