Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения
Разрешения с наименьшими привилегиями
Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)
Mail.ReadWrite
Недоступно.
Делегированные (личная учетная запись Майкрософт)
Mail.ReadWrite
Недоступно.
Для приложений
Mail.ReadWrite
Недоступно.
HTTP-запрос
POST /me/mailFolders/{id}/childFolders
POST /users/{id | userPrincipalName}/mailFolders/{id}/childFolders
Укажите родительскую папку в URL-адресе запроса в качестве идентификатора папки или известного имени папки. Список поддерживаемых известных имен см. в статье Тип ресурса mailFolder.
Заголовки запросов
Заголовок
Значение
Авторизация
Bearer {token}. Обязательно.
Content-Type
application/json. Обязательно.
Текст запроса
В тексте запроса предоставьте JSON-объект с указанными ниже параметрами.
Параметр
Тип
Описание
@odata.type
String
Тип создаваемой папки. Задайте для параметра значение microsoft.graph.mailSearchFolder.
displayName
String
Отображаемое имя новой папки.
includeNestedFolders
Логический
Указывает, как иерархия папок почтовых ящиков должна проходить в поиске. true означает, что необходимо выполнить глубокий поиск, чтобы включить дочерние папки в иерархию каждой папки, явно указанной в sourceFolderIds. false означает неглубокий поиск только каждой из папок, явно указанных в sourceFolderIds.
sourceFolderIds
Коллекция строк
Папки почтового ящика, которые должны быть заминированы.
filterQuery
String
Запрос OData для фильтрации сообщений.
Отклик
В случае успешного 201 Created выполнения этот метод возвращает код ответа и объект mailSearchFolder в тексте ответа.
Пример
Запрос
Ниже приведен пример запроса: он создает папку поиска сообщений, которая содержит строку "еженедельный дайджест" в теме. Папка поиска находится в той же папке, к которой применяется указанный запрос фильтра.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new MailSearchFolder
{
OdataType = "microsoft.graph.mailSearchFolder",
DisplayName = "Weekly digests",
IncludeNestedFolders = true,
SourceFolderIds = new List<string>
{
"AQMkADYAAAIBDAAAAA==",
},
FilterQuery = "contains(subject, 'weekly digest')",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.MailFolders["{mailFolder-id}"].ChildFolders.PostAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
MailSearchFolder mailFolder = new MailSearchFolder();
mailFolder.setOdataType("microsoft.graph.mailSearchFolder");
mailFolder.setDisplayName("Weekly digests");
mailFolder.setIncludeNestedFolders(true);
LinkedList<String> sourceFolderIds = new LinkedList<String>();
sourceFolderIds.add("AQMkADYAAAIBDAAAAA==");
mailFolder.setSourceFolderIds(sourceFolderIds);
mailFolder.setFilterQuery("contains(subject, 'weekly digest')");
MailFolder result = graphClient.me().mailFolders().byMailFolderId("{mailFolder-id}").childFolders().post(mailFolder);
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.