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


Обновление educationAssignmentDefaults

Пространство имен: microsoft.graph

Обновите свойства объекта educationAssignmentDefaults .

Только преподаватели могут обновить эти параметры.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) EduAssignments.ReadWriteBasic EduAssignments.ReadWrite
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Не поддерживается. Не поддерживается.

HTTP-запрос

PATCH /education/classes/{id}/assignmentDefaults

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

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

В следующей таблице указаны свойства, которые можно обновить.

Свойство Тип Описание
addedStudentAction educationAddedStudentAction Действия по умолчанию на уровне класса для учащихся, добавленные после даты публикации задания. Возможные значения: none, assignIfOpen. Значение по умолчанию — none.
addToCalendarAction educationAddToCalendarOptions Необязательное поле для управления поведением заданий для добавления заданий в календари учащихся и преподавателей при публикации задания . Допустимые значения: none, studentsAndPublisher, studentsAndTeamOwners, unknownFutureValue, studentsOnly. Обратите внимание, что необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующее значение из этого развиваемого перечисления: studentsOnly. Необязательный параметр.
dueTime TimeOfDay Значение по умолчанию на уровне класса для поля due time. Значение по умолчанию: 23:59:00.
notificationChannelUrl String Канал Teams по умолчанию для отправки уведомлений, связанных с назначением. Значение по умолчанию — null.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код ответа и обновленный объект educationAssignmentDefaults в теле отклика.

Примеры

Запрос

PATCH https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignmentDefaults
Content-Type: application/json

{
  "addedStudentAction": "assignIfOpen",
  "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('acdefc6b-2dc6-4e71-b1e9-6d9810ab1793')/channels('3da03fc4-8eac-4459-84fb-1422dc01f65e')"
}

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "addedStudentAction": "assignIfOpen",
  "dueTime": "String",
  "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('acdefc6b-2dc6-4e71-b1e9-6d9810ab1793')/channels('3da03fc4-8eac-4459-84fb-1422dc01f65e')"
}