Тип ресурса mailSearchFolder

Статья
08/24/2024

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

Важно!

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

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

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

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

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

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

Методы

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

Свойства

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

Связи

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

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

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

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

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