更新 educationRubric
命名空间:microsoft.graph
更新 educationRubric 对象的属性。 只有教师才能执行此操作。
只有在发布作业之前,才能更新附加到作业 (PATCH /education/classes/{class-id}/assignments/{assignment-id}/rubric
) 的评分标准,而更新的内容实际上是 下 /education/users/{id}/rubrics
存在的原始评分标准。 发布分配后,将创建附加到该特定分配的不可变的评分标准副本。 可以使用 GET /education/classes/{class-id}/assignments/{assignment-id}/rubric 检索该评分标准,但无法更新。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | EduAssignments.ReadWriteBasic | EduAssignments.ReadWrite |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | 不支持。 | 不支持。 |
HTTP 请求
PATCH /education/me/rubrics/{rubric-id}
PATCH /education/classes/{class-id}/assignments/{assignment-id}/rubric
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
在请求正文中,提供应更新的相关字段的值。 请求正文中未包含的现有属性会保留其以前的值,或者根据对其他属性值的更改重新计算。 为了获得最佳性能,请勿加入尚未更改的现有值。
属性 | 类型 | 说明 |
---|---|---|
说明 | itemBody | 此评分标准的说明。 |
displayName | String | 此评分标准的名称。 |
分级 | educationAssignmentGradeType | 评分标准的评分类型。 null 如果这是无积分评分标准,则 为 educationAssignmentPointsGradeType (如果它是带积分的评分标准)。 |
水平 | rubricLevel 集合 | 组成此评分标准的级别的集合。 |
光荣 | rubricQuality 集合 | 组成此评分标准的质量集合。 |
响应
如果成功,此方法在响应正文中返回响应 200 OK
代码和更新的 educationRubric 对象。
示例
请求
以下示例显示了一个请求。
PATCH https://graph.microsoft.com/v1.0/education/me/rubrics/ceb3863e-6912-4ea9-ac41-3c2bb7b6672d
Content-type: application/json
{
"displayName": "Example Credit Rubric after display name patch"
}
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"displayName": "Example Credit Rubric after display name patch",
"id": "c4459fcb-a761-4f70-ac5b-e9466cb77c2a",
"description": {
"content": "This is an example of a credit rubric (no points)",
"contentType": "text"
},
"levels": [
{
"levelId": "dec665d4-cf1b-4481-ac61-1d5b6188f4f5",
"displayName": "Good",
"description": {
"content": "",
"contentType": "text"
}
},
{
"levelId": "3f2e4b0f-508e-4005-984b-17e061bc5377",
"displayName": "Poor",
"description": {
"content": "",
"contentType": "text"
}
}
],
"qualities": [
{
"qualityId": "dc79dcbf-b536-4797-9c5b-902f28129fd0",
"description": {
"content": "Argument",
"contentType": "text"
},
"criteria": [
{
"id": "8937fa15-4a7c-4f27-bd01-ca3471d2d1d5",
"description": {
"content": "The essay's argument is persuasive.",
"contentType": "text"
}
},
{
"id": "4dfb5263-1d3f-4f0a-93ef-d24d800d0f69",
"description": {
"content": "The essay's argument does not make sense.",
"contentType": "text"
}
}
]
},
{
"qualityId": "7e087062-ac25-4629-8386-a946350936db",
"description": {
"content": "Spelling and Grammar",
"contentType": "text"
},
"criteria": [
{
"id": "12276eb2-122c-4ad2-ba92-335ea798c88e",
"description": {
"content": "The essay uses proper spelling and grammar with few or no errors.",
"contentType": "text"
}
},
{
"id": "3db7e6b2-2b1b-4f8e-9fca-bea701159145",
"description": {
"content": "The essay has numerous errors in spelling and/or grammar.",
"contentType": "text"
}
}
]
}
]
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈