Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: 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)"
}