Тип ресурса задачи (не рекомендуется)
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Предостережение
Набор API задач, созданный на основе baseTask , был не рекомендуется использовать 31 мая 2022 г. и перестал возвращать данные 31 августа 2022 г. Вместо этого используйте API todoTask .
Представляет задачу, например рабочий элемент или личный элемент, который можно отслеживать и выполнять. Задача всегда содержится в базовом списке задач.
Этот ресурс поддерживает следующее:
- Добавление данных в качестве настраиваемых свойств в открытых расширениях.
- подписку на уведомления об изменениях;
- Использование разностного запроса для отслеживания добавочных добавлений, удалений и обновлений.
Наследует от baseTask.
Методы
| Метод | Тип возвращаемых данных | Описание |
|---|---|---|
| Перечисление задач | коллекция задач | Получение списка объектов задачи и их свойств. |
| Вывод задачи | task | Чтение свойств и связей объекта задачи . |
| Обновление задачи | task | Обновление свойств объекта задачи . |
| Удаление задачи | Нет | Удаляет объект задачи . |
| move | baseTask | Переместите сообщение в другой список. |
| Список контрольных элементов | Коллекция checklistItem | Получите ресурсы checklistItem из свойства навигации checklistItems. |
| Создание checklistItem | checklistItem | Создайте новый объект checklistItem. |
| Вывод списка связанныхресурсов | коллекция linkedResource_v2 | Получите ресурсы linkedResource_v2 из свойства навигации linkedResources. |
| Создание linkedResource | linkedResource_v2 | Создайте новый объект linkedResource_v2. |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| textbody | itemBody | Текст задачи в текстовом формате, который обычно содержит сведения о задаче. Наследуется от baseTask. |
| bodyLastModifiedDateTime | DateTimeOffset | Дата и время последнего изменения задачи. По умолчанию используется формат UTC. Можно указать пользовательский часовой пояс в заголовке запроса. Значение свойства представлено в формате ISO 8601 (всегда используется формат UTC). Например, полночь в формате UTC 1 января 2020 г. будет выглядеть следующим образом: "2020-01-01T00:00:00Z". Наследуется от baseTask. |
| completedDateTime | DateTimeOffset | Дата завершения задачи. Наследуется от baseTask. |
| createdDateTime | DateTimeOffset | Дата и время создания задачи. По умолчанию используется формат UTC. Можно указать пользовательский часовой пояс в заголовке запроса. Значение свойства представлено в формате ISO 8601. Например, полночь в формате UTC 1 января 2020 г. будет выглядеть следующим образом: "2020-01-01T00:00:00Z". Наследуется от baseTask. |
| displayName | String | Имя задачи. Наследуется от baseTask. |
| dueDateTime | dateTimeTimeZone | Дата в указанном часовом поясе, когда задача должна быть завершена. Наследуется от baseTask. |
| id | String | Уникальный идентификатор задачи. По умолчанию это значение не изменяется, если задача перемещается из одного списка в другой. Наследуется от baseTask. |
| importance | importance | Важность задачи. Возможные значения: low, normal, high. Наследуется от baseTask. Допустимые значения: low, normal, high. |
| lastModifiedDateTime | DateTimeOffset | Дата и время последнего изменения задачи. По умолчанию используется формат UTC. Можно указать пользовательский часовой пояс в заголовке запроса. Значение свойства представлено в формате ISO 8601 (всегда используется формат UTC). Например, полночь в формате UTC 1 января 2020 г. будет выглядеть следующим образом: "2020-01-01T00:00:00Z". Наследуется от baseTask. |
| точка зрения | taskViewpoint | Свойства, которые являются личными для пользователя, такие как reminderDateTime и категории. Наследуется от baseTask. |
| recurrence | patternedRecurrence | Расписание повторения задачи. Наследуется от baseTask. |
| startDateTime | dateTimeTimeZone | Дата в указанном часовом поясе, когда задача должна быть начата. Наследуется от baseTask. |
| status | taskStatus_v2 | Указывает состояние или ход выполнения задачи. Возможные значения: notStarted, inProgress, completed, .unknownFutureValue Наследуется от baseTask. |
Связи
| Связь | Тип | Описание |
|---|---|---|
| checklistItems | Коллекция checklistItem | Коллекция элементов checklistItems, связанных с задачей. Наследуется от baseTask |
| extensions | Коллекция extension | Коллекция открытых расширений, определенных для задачи . Наследуется от baseTask |
| linkedResources | коллекция linkedResource_v2 | Коллекция ресурсов, связанных с задачей. Наследуется от baseTask |
| parentList | baseTaskList | Список, содержащий задачу. Наследуется от baseTask |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"@odata.type": "#microsoft.graph.task",
"textBody": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)",
"completedDateTime": "String (timestamp)",
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"displayName": "String",
"status": "String",
"viewpoint": {
"@odata.type": "microsoft.graph.taskViewpoint"
},
"id": "String (identifier)"
}