Создание baseTask (не рекомендуется)
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Предостережение
Набор API задач, созданный на основе baseTask , был не рекомендуется использовать 31 мая 2022 г. и перестал возвращать данные 31 августа 2022 г. Вместо этого используйте API todoTask .
Создайте новый объект baseTask в конкретном baseTaskList.
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | Tasks.ReadWrite | Недоступно. |
Делегированные (личная учетная запись Майкрософт) | Tasks.ReadWrite | Недоступно. |
Для приложений | Не поддерживается. | Не поддерживается. |
HTTP-запрос
POST /me/tasks/lists/{baseTaskListId}/tasks
POST /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите представление объекта baseTask в формате JSON.
При создании baseTask можно указать следующие свойства.
Свойство | Тип | Описание |
---|---|---|
textBody | String | Текст задачи в текстовом формате, который обычно содержит сведения о задаче. |
createdDateTime | DateTimeOffset | Дата в указанном часовом поясе, когда задача была завершена. |
lastModifiedDateTime | DateTimeOffset | Дата и время последнего изменения задачи. По умолчанию используется формат UTC. Можно указать пользовательский часовой пояс в заголовке запроса. Значение свойства представлено в формате ISO 8601 (всегда используется формат UTC). Например, полночь в формате UTC 1 января 2020 г. будет выглядеть следующим образом: "2020-01-01T00:00:00Z". |
bodyLastModifiedDateTime | DateTimeOffset | Дата и время последнего изменения задачи. По умолчанию используется формат UTC. Можно указать пользовательский часовой пояс в заголовке запроса. Значение свойства представлено в формате ISO 8601 (всегда используется формат UTC). Например, полночь в формате UTC 1 января 2020 г. будет выглядеть следующим образом: "2020-01-01T00:00:00Z". |
completedDateTime | DateTimeOffset | Дата в указанном часовом поясе, когда задача была завершена. |
dueDateTime | dateTimeTimeZone | Дата в указанном часовом поясе, когда задача должна быть завершена. |
startDateTime | dateTimeTimeZone | Дата в указанном часовом поясе, когда задача должна быть начата. |
importance | importance | Важность задачи. Допустимые значения: low , normal , high . |
recurrence | patternedRecurrence | Расписание повторения задачи. |
displayName | String | Краткое описание задачи. |
status | taskStatus_v2 | Указывает состояние или ход выполнения задачи. Допустимые значения: notStarted , inProgress , completed , unknownFutureValue . Обязательно. |
точка зрения | taskViewpoint | Свойства, которые являются личными для пользователя, например reminderDateTime. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 201 Created
и объект baseTask в теле отклика.
Примеры
Запрос
POST https://graph.microsoft.com/beta/me/tasks/lists/AQMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNi/tasks
Content-Type: application/json
Content-length: 634
{
"@odata.type": "#microsoft.graph.task",
"textBody": "String",
"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"
}
}
Отклик
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.task",
"@odata.etag": "W/\"kOO4xOT//0qFRAqk3TNe0QAABCE1Xg==\"",
"importance": "normal",
"status": "notStarted",
"displayName": "Buy medicine",
"createdDateTime": "2021-11-17T10:11:18.0229364Z",
"lastModifiedDateTime": "2021-11-17T10:11:18.19789Z",
"id": "AAkALgAAAAAAHYQDEapmEc2byACqAC",
"textBody": "",
"parentList": {
"id": "AQMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNi"
}
}