тип ресурса todoTask
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
TodoTask представляет задачу, например рабочую часть или личный элемент, которую можно отслеживать и выполнять.
TodoTask всегда содержится в todoTaskList. Он включает связь с коллекцией объектов linkedResource , отслеживая один или несколько источников задачи.
Этот ресурс поддерживает следующее:
- Добавление данных в качестве настраиваемых свойств в открытых расширениях.
- подписку на уведомления об изменениях;
- Использование разностного запроса для отслеживания добавочных добавлений, удалений и обновлений.
Методы
| Метод | Тип возвращаемых данных | Описание |
|---|---|---|
| Перечисление задач | Коллекция todoTask | Получение всех ресурсов todoTask в указанном списке. |
| Создание задачи | todoTask | Создание todoTask в указанном списке задач |
| Вывод задачи | todoTask | Чтение свойств и связей объекта todoTask . |
| Обновление задачи | todoTask | Обновите свойства объекта todoTask . |
| Удаление задачи | Нет | Удаляет объект todoTask . |
| Список контрольных элементов | Коллекция checklistItem | Получите ресурсы checklistItem из свойства навигации checklistItems. |
| Создание checklistItem | checklistItem | Создайте новый объект checklistItem . |
| Вывод списка связанныхресурсов | Коллекция linkedResource | Получите linkedResources из свойства навигации linkedResources. |
| Создание linkedResources | linkedResource | Создайте новый объект linkedResources. |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| 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 | Краткое описание задачи. |
Связи
| Связь | Тип | Описание |
|---|---|---|
| attachments | Коллекция taskFileAttachment | Коллекция файловых вложений для задачи. |
| checklistItems | Коллекция checklistItem | Коллекция небольших подзадач, связанных с более сложной родительской задачей. |
| extensions | Коллекция extension | Коллекция открытых расширений, определенных для задачи. Допускается значение null. |
| linkedResources | Коллекция linkedResource | Коллекция ресурсов, связанных с задачей. |
Представление 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"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"status": "String",
"title": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)"
}