Тип ресурса mailSearchFolder
Пространство имен: 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"
}