Тип ресурса todoTask

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

todoTask представляет собой задачу, например часть работы или личный элемент, которую можно отслеживать и выполнять.

Задача todoTask всегда содержится в списке задач todoTaskList. Он включает связь с коллекцией объектов linkedResource , отслеживающую один или несколько источников задачи.

Этот ресурс поддерживает следующее:

Методы

Метод Тип возвращаемых данных Описание
Перечисление задач Коллекция todoTask Получение всех ресурсов todoTask в указанном списке.
Создание задачи todoTask Создание задачи todo в указанном списке задач
Вывод задачи todoTask Чтение свойств и связей объекта todoTask .
Обновление задачи todoTask Обновление свойств объекта todoTask .
Удаление задачи Нет Удаляет объект todoTask .
Контрольный список элементов списка контрольный списокколлекция элементов Получите ресурсы checklistItem из свойства навигации checklistItems.
Создать элемент контрольного списка элемент контрольного списка Создайте новый объект checklistItem .
List linkedResources linkedКоллекция ресурсов Получите linkedResources из свойства навигации linkedResources.
Создание linkedResources linkedResource Создание нового объекта linkedResources.
Расширенные свойства
Создание однозначного свойства todoTask Создайте одно или несколько расширенных свойств с одним значением в новом или существующем объекте todoTask .
Получение однозначного свойства todoTask Получение объектов todoTask , содержащих расширенное свойство с одним значением, с помощью или $expand$filter.

Свойства

Свойство Тип Описание
body itemBody Текст задачи, который обычно содержит сведения о задаче.
bodyLastModifiedDateTime DateTimeOffset Дата и время последнего изменения текста задачи. По умолчанию используется формат UTC. Можно указать пользовательский часовой пояс в заголовке запроса. Значение свойства представлено в формате ISO 8601 (всегда используется формат UTC). Например, полночь по UTC 1 января 2020 г. будет выглядеть так: "2020-01-01T00:00:00Z".
categories Коллекция String Категории, связанные с задачей. Каждая категория соответствует свойству displayName объекта outlookCategory, определенному пользователем.
completedDateTime dateTimeTimeZone Дата и время в указанном часовом поясе, когда задача была завершена.
createdDateTime DateTimeOffset Дата и время создания задачи. По умолчанию используется формат UTC. Можно указать пользовательский часовой пояс в заголовке запроса. Значение свойства представлено в формате ISO 8601. Например, полночь по UTC 1 января 2020 г. будет выглядеть так: "2020-01-01T00:00:00Z".
dueDateTime dateTimeTimeZone Дата и время в указанном часовом поясе, когда задача должна быть завершена.
hasAttachments Boolean Указывает, есть ли у задачи вложения.
id String Уникальный идентификатор задачи. По умолчанию это значение меняется при перемещении элемента из одного списка в другой.
importance importance Важность задачи. Допустимые значения: low, normal, high.
isReminderOn Boolean Присвоено значение true, если установлено напоминание пользователю о задаче.
lastModifiedDateTime DateTimeOffset Дата и время последнего изменения задачи. По умолчанию используется формат UTC. Можно указать пользовательский часовой пояс в заголовке запроса. Значение свойства представлено в формате ISO 8601 (всегда используется формат UTC). Например, полночь по UTC 1 января 2020 г. будет выглядеть так: "2020-01-01T00:00:00Z".
recurrence patternedRecurrence Расписание повторения задачи.
reminderDateTime dateTimeTimeZone Дата и время в указанном часовом поясе для напоминания о задаче.
startDateTime dateTimeTimeZone Дата и время в указанном часовом поясе, в котором запланировано начало задачи.
status taskStatus Указывает состояние или ход выполнения задачи. Допустимые значения: notStarted, inProgress, completed, waitingOnOthers, deferred.
title String Краткое описание задачи.

Задачи можно экспортировать с помощью PST-загрузки, описанной в статье Экспорт результатов поиска контента с портала Microsoft Purview. Вы можете сослаться на todoTask сопоставление между свойствами и свойствами в экспортированном PST-файле в обзоре To Do API.

Связи

Связь Тип Описание
attachments Коллекция taskFileAttachment Коллекция вложенных файлов для задачи.
checklistItems контрольный списокколлекция элементов Коллекция элементов контрольного списка, связанных с задачей.
extensions Коллекция extension Коллекция открытых расширений, определенных для задачи. Допускается значение null.
linkedResources linkedКоллекция ресурсов Коллекция ресурсов, связанных с задачей.
singleValueExtendedProperties Коллекция singleValueExtendedProperty Коллекция настраиваемых полей, связанных с задачей.

Представление JSON

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

{
  "@odata.type": "#microsoft.graph.todoTask",
  "id": "String (identifier)",
  "body": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "categories": ["string"],
  "completedDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "importance": "String",
  "isReminderOn": "Boolean",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  },
  "reminderDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}