Поделиться через


Тип ресурса mailSearchFolder

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

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

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

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

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

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

Методы

Метод Возвращаемый тип Описание
Создание папки поиска почты 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"
}