Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档。
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,则会导致错误。
可指定以下字段:
gradingPeriods
applyToExistingCoursework
这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo" 。
|
previewVersion |
enum (PreviewVersion )
可选。API 的预览版本。必须设置此字段,才能使用预览版计划中向开发者提供的新的 API 功能。
|
响应正文
如果成功,则响应正文包含一个 GradingPeriodSettings
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/classroom.courses
有关详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-08-15。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{
"lastModified": "最后更新时间 (UTC):2024-08-15。",
"confidential": False
}