mailSearchFolder тип ресурса

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

Важно!

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

mailSearchFolder — это виртуальная папка в почтовом ящике пользователя, содержащая все элементы электронной почты, удовлетворяющие заданным условиям поиска. mailSearchFolder наследует mailFolder. Папки поиска можно создавать в любой папке почтового ящика пользователя Exchange Online. Однако чтобы папка поиска отобразилась в Outlook, Outlook для Интернета или Outlook Live, она должна быть создана в папке WellKnownFolderName.SearchFolders.

Жизненный цикл папок поиска

Exchange Online может удалять папки поиска, созданные приложением, по одной из следующих причин:

1. Срок действия папок поиска истекает, если они не используются в течение 45 дней.
2. Существует ограничение на количество папок поиска, которые можно создать в одной исходной папке. При нарушении этого ограничения старые папки поиска удаляются, чтобы освободить место для новых.

При удалении папки поиска приложение должно создать новый ресурс папки поиска и использовать его.

Методы

Метод	Возвращаемый тип	Описание
Создание	mailSearchFolder	Создайте папку поиска в почтовом ящике этого пользователя.
Получение	mailSearchFolder	Получение указанной папки поиска.
Обновление	mailSearchFolder	Обновите указанную папку поиска.
Delete	Нет	Удалите указанную папку поиска.
Удалить без возможности восстановления	Нет	Окончательное удаление папки поиска почты и удаление ее элементов из почтового ящика пользователя.
Перечисление дочерних папок	Коллекция mailFolder	Получить список всех папок в почтовом ящике этого пользователя, включая папки поиска.
Перечисление сообщений в папке	Коллекция message	Вывод списка всех сообщений в указанной папке поиска.

Свойства

Свойство	Тип	Описание
isSupported	Логический	Указывает, можно ли редактировать папку поиска с помощью REST API.
includeNestedFolders	Логический	Указывает, как следует обходить иерархию папок почтового ящика при поиске. true означает, что необходимо выполнить глубокий поиск для включения дочерних папок в иерархию каждой папки, явно указанную в sourceFolderIds. false означает неглубокий поиск только в каждой из папок, явно указанных в sourceFolderIds.
sourceFolderIds	Коллекция строк	Папки почтовых ящиков, которые необходимо доработать.
Запрос фильтра	String	Запрос OData для фильтрации сообщений.

Связи

Отсутствуют.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "isSupported": true,
  "includeNestedFolders": true,
  "sourceFolderIds": ["string"],
  "filterQuery": "string"
}