Тип ресурса mailSearchFolder

Статья
05/24/2024

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

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

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

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

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

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

Методы

Метод	Возвращаемый тип	Описание
Создание папки поиска почты	mailSearchFolder	Create папку поиска в почтовом ящике этого пользователя.
Перечисление дочерних папок	Коллекция 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"
}

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