Тип ресурса mailSearchFolder

Статья
04/22/2024

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

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

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

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

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

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

Методы

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

Свойства

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

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

Ниже указано представление ресурса в формате JSON.

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