Обновление данных о назначениях и оценках

Статья
03/21/2024

Образовательные учреждения имеют пользовательские инструменты для обновления данных о заданиях и оценках. Например, преподавателю может потребоваться обновить задание, прежде чем учащиеся отправят их, или внести изменения в оценку (результат) с помощью пользовательского средства.

Перед обновлением данных необходимо получить соответствующие сведения о классе и члене.

Примечание: Вы можете использовать Обозреватель Graph для тестирования API для образовательных учреждений, упомянутых в этой статье.

Получение сведений о классе и члене

Все задания и сведения о классификации входят в состав команды в Microsoft Teams. Сведения о классах, участниках и ролях (учащегося или преподавателя) в команде можно получить с помощью следующих API Teams:

Список классов educationSchools. Возвращает список всех классов в клиенте для образовательных учреждений.
Список членов educationClass: Списки сведения о членах определенного класса.

После получения соответствующих сведений о классе и участниках вы можете получить необходимые сведения о задании и оценок.

Сведения о назначении и отправке

Все сведения об заданиях и учащихся связаны с данными о классе и отправке соответственно. Следующие API-интерфейсы извлекают сведения о назначениях и отправке классов:

Тип ресурса educationAssignment: Списки все методы, доступные для назначений в классе. Пользователь может получить все объекты educationAssignmentResource , связанные с назначением.
Тип ресурса educationSubmission: создается submissionId для каждого учащегося, для которого опубликовано задание. Этот API можно использовать для получения состояния отправки, например, от того, была ли она передана и оценивалась, (ресурсы), отправленные учащимся, и оценку (результат) для отправки.

Обновление данных оценок (результатов)

Пользователи могут обновлять свойства объекта educationOutcome . Существующие свойства, которые не включены в текст запроса, будут поддерживать свои предыдущие значения. Эту операцию могут выполнять только преподаватели.

В следующем примере описывается, как обновить результат в точках.

Запрос

Ниже показан пример запроса.

Примечание: Текст запроса должен содержать только значения полей, которые необходимо обновить.

PATCH https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/submissions/d1bee293-d8bb-48d4-af3e-c8cb0e3c7fe7/outcomes/9c0f2850-ff8f-4fd6-b3ac-e23077b59141
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.educationPointsOutcome",
    "points":{
        "@odata.type":"#microsoft.graph.educationAssignmentPointsGrade",
        "points":85.0
    }
}

Отклик

В следующем примере показан resposnse.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.educationPointsOutcome",
    "id":"ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
    "lastModifiedBy":{
        "user":{
            "id":"9391878d-903c-406c-bb1c-0f17d00fd878"
        }
    },
    "points":{
        "gradedDateTime":"2019-07-15T22:35:48.2429387Z",
        "points":85.0,
        "gradedBy":{
            "user":{
                "id":"9391878d-903c-406c-bb1c-0f17d00fd878"
            }
        }
    }
}

Этот запрос возвращает обновленный объект educationOutcome в тексте ответа.

Разрешения

Для обновления данных в назначениях требуются делегированные разрешения и разрешения приложений. Разрешения приложений сейчас поддерживаются только в бета-версии.

Примечание: Так как сведения об учащихся и оценках являются конфиденциальными данными, обязательно проверьте, какие разрешения требуются.

Поделиться через