Обновление educationRubric
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Обновление свойств объекта educationRubric . Эту операцию могут выполнять только преподаватели.
Обновление рубрики, присоединенной к назначению (PATCH /education/classes/{id}/assignments/{id}/rubric
), возможно только до публикации назначения, а обновление фактически является исходной рубрикой, которая существует в ./education/users/{id}/rubrics
После публикации задания создается неизменяемая копия рубрики, которая присоединяется к конкретному назначению. Этот рубрику можно получить с помощью get /education/classes/{id}/assignments/{id}/rubric, но его невозможно обновить.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | EduAssignments.ReadWriteBasic | EduAssignments.ReadWrite |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Для приложений | Не поддерживается. | Не поддерживается. |
HTTP-запрос
PATCH /education/me/rubrics/{id}
PATCH /education/classes/{id}/assignments/{id}/rubric
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Текст запроса
В тексте запроса укажите значения для соответствующих полей, которые необходимо обновить. Предыдущие значения существующих свойств, не включенных в текст запроса, останутся прежними или будут повторно вычислены с учетом измененных значений других свойств. Для достижения оптимальной производительности не включайте существующие значения, которые не изменились.
Свойство | Тип | Описание |
---|---|---|
description | itemBody | Описание этой рубрики. |
displayName | String | Название этой рубрики. |
Профилирования | educationAssignmentGradeType | Тип оценки в рубрике. null для рубрики без баллов и educationAssignmentPointsGradeType для рубрики с баллами. |
Уровней | коллекция rubricLevel | Коллекция уровней, составляющих эту рубрику. |
Качества | коллекция rubricQuality | Коллекция качеств, составляющих эту рубрику. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK
и обновленный объект educationRubric в теле отклика.
Примеры
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/beta/education/me/rubrics/{id}
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 Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по