Тип ресурса outlookTask (нерекомендуемый)

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Предостережение

API задач Outlook устарел и перестанет возвращать данные 20 августа 2022 г. Используйте новый API To Do. Дополнительные сведения см. в статье 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 outlookTask Получение свойств и связей задачи Outlook в почтовом ящике пользователя.
Обновление outlookTask Изменение записываемых свойств задачи Outlook.
Удаление Нет Удаление определенной задачи в почтовом ящике пользователя.
Завершение Коллекция 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"
}