Тип ресурса outlookTask (нерекомендуемый)
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Предостережение
API задач Outlook устарел и не возвращает данные 20 августа 2022 г. Вместо этого используйте API To Do .
Элемент Outlook, который может отслеживать рабочий элемент.
Вы можете использовать задачу для отслеживания:
- Даты и время начала, срока выполнения и фактического завершения.
- Ход выполнения или состояние задачи.
- Состояние повторения и напоминания задачи.
Свойства, связанные с датами в ресурсе outlookTask, включают указанные ниже:
- completedDateTime
- createdDateTime
- dueDateTime
- lastModifiedDateTime
- reminderDateTime
- startDateTime
По умолчанию операции POST, GET, PATCH и complete возвращают связанные с датами свойства в откликах REST в формате UTC.
Можно использовать заголовок Prefer: outlook.timezone, чтобы все свойства, связанные с датами, были представлены в часовом поясе, отличном от UTC. В приведенном ниже примере связанные с датами свойства возвращаются в соответствующем отклике в часовом поясе EST:
Prefer: outlook.timezone="Eastern Standard Time"
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Получение | outlookTask | Получение свойств и связей задачи Outlook в почтовом ящике пользователя. |
| Обновление | outlookTask | Изменение записываемых свойств задачи Outlook. |
| Удаление | Нет | Удаление определенной задачи в почтовом ящике пользователя. |
| Удалить без возможности восстановления | Нет | Окончательно удалите задачу Outlook и поместите ее в папку Purges в папке "Элементы с возможностью восстановления" в почтовом ящике пользователя. |
| Завершение | Коллекция outlookTask | Завершите задачу Outlook, которая задает для свойства completedDateTime текущую дату, а для свойства status — значение completed. |
| Вложения | ||
| Список вложений | Коллекция attachment | Получение всех вложений для задачи Outlook. |
| Добавление вложения | attachment | Добавление файла, элемента (сообщения, события или контакта) или ссылки на файл в виде вложения в задачу. |
| Расширенные свойства | ||
| Создание однозначного свойства | outlookTask | Создание одного или нескольких расширенных свойств с одним значением в новой или существующей задаче Outlook. |
| Получение однозначного свойства | outlookTask | Получение задач Outlook, которые содержат расширенное свойство с одним значением, при помощи $expand или $filter. |
| Создание свойства с несколькими значениями | outlookTask | Создание одного или нескольких расширенных свойств с несколькими значениями в новой или существующей задаче Outlook. |
| Получение свойства с несколькими значениями | outlookTask | Получение задачи Outlook, которая содержит расширенное свойство с несколькими значениями, с помощью параметра $expand. |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| assignedTo | String | Имя пользователя, которому назначена задача в Outlook. Только для чтения. |
| body | itemBody | Текст задачи, который обычно содержит сведения о задаче. Поддерживается только тип HTML. |
| categories | Коллекция String | Категории, связанные с задачей. Каждая категория соответствует свойству displayName объекта outlookCategory, определенному пользователем. |
| changeKey | String | Версия задачи. |
| completedDateTime | dateTimeTimeZone | Дата в указанном часовом поясе, когда задача была завершена. |
| createdDateTime | DateTimeOffset | Дата и время создания задачи. По умолчанию используется формат UTC. Можно указать пользовательский часовой пояс в заголовке запроса. Значение свойства представлено в формате ISO 8601. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| dueDateTime | dateTimeTimeZone | Дата в указанном часовом поясе, когда задача должна быть завершена. |
| hasAttachments | Boolean | Присвоено значение true, если у задачи есть вложения. |
| id | String | Уникальный идентификатор задачи.
По умолчанию это значение изменяется при перемещении элемента из одного контейнера (например, папки или календаря) в другой. Чтобы изменить это поведение, используйте заголовок Prefer: IdType="ImmutableId". Дополнительные сведения см. в статье Получение неизменяемых идентификаторов для ресурсов Outlook. Только для чтения. |
| importance | importance | Важность события. Возможные значения: low, normal, high. |
| isReminderOn | Boolean | Присвоено значение true, если установлено напоминание пользователю о задаче. |
| lastModifiedDateTime | DateTimeOffset | Дата и время последнего изменения задачи. По умолчанию используется формат UTC. Можно указать пользовательский часовой пояс в заголовке запроса. Значение свойства представлено в формате ISO 8601 (всегда используется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| owner | String | Имя пользователя, создавшего задачу. |
| parentFolderId | String | Уникальный идентификатор родительской папки задачи. |
| recurrence | patternedRecurrence | Расписание повторения задачи. |
| reminderDateTime | dateTimeTimeZone | Дата и время появления напоминания о задаче. |
| sensitivity | sensitivity | Указывает уровень конфиденциальности для задачи. Возможные значения: normal, personal, private, confidential. |
| startDateTime | dateTimeTimeZone | Дата в указанном часовом поясе, когда задача должна быть начата. |
| status | taskStatus | Указывает состояние или ход выполнения задачи. Возможные значения: notStarted, inProgress, completed, waitingOnOthers, deferred. |
| subject | String | Краткое описание или название задачи. |
Связи
| Связь | Тип | Описание |
|---|---|---|
| attachments | Коллекция attachment | Коллекция вложений fileAttachment, itemAttachment и referenceAttachment для задачи. Только для чтения. Допускается значение null. |
| multiValueExtendedProperties | Коллекция multiValueLegacyExtendedProperty | Коллекция расширенных свойств с несколькими значениями, определенных для задачи. Только для чтения. Допускается значение null. |
| singleValueExtendedProperties | Коллекция singleValueLegacyExtendedProperty | Коллекция расширенных свойств с одним значением, определенных для задачи. Только для чтения. Допускается значение null. |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"assignedTo": "String",
"body": {"@odata.type": "microsoft.graph.itemBody"},
"categories": ["String"],
"changeKey": "String",
"completedDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"createdDateTime": "String (timestamp)",
"dueDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"hasAttachments": true,
"id": "String (identifier)",
"importance": "string",
"isReminderOn": true,
"lastModifiedDateTime": "String (timestamp)",
"owner": "String",
"parentFolderId": "String",
"recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
"reminderDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"sensitivity": "string",
"startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"status": "string",
"subject": "String"
}