Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungstyp
Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)
Mail.ReadWrite
Delegiert (persönliches Microsoft-Konto)
Mail.ReadWrite
Anwendung
Mail.ReadWrite
HTTP-Anforderung
POST /me/mailFolders
POST /users/{id | userPrincipalName}/mailFolders
Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.
displayName und isHidden sind die einzigen beschreibbaren Eigenschaften für ein mailFolder-Objekt .
Parameter
Typ
Beschreibung
displayName
String
Der Anzeigename für den neuen Ordner.
isHidden
Boolescher Wert
Gibt an, ob der neue Ordner ausgeblendet ist. Der Standardwert ist false. Das Festlegen der Eigenschaft ist optional. Nach dem Festlegen können Sie diese Eigenschaft nicht mehr aktualisieren. Weitere Informationen finden Sie unter Ausgeblendete E-Mail-Ordner.
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode und ein mailFolder-Objekt im Antworttext zurück201 Created.
POST https://graph.microsoft.com/v1.0/me/mailFolders
Content-type: application/json
{
"displayName": "Clutter",
"isHidden": true
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new MailFolder
{
DisplayName = "Clutter",
IsHidden = true,
};
// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.MailFolders.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewMailFolder()
displayName := "Clutter"
requestBody.SetDisplayName(&displayName)
isHidden := true
requestBody.SetIsHidden(&isHidden)
// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
mailFolders, err := graphClient.Me().MailFolders().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
MailFolder mailFolder = new MailFolder();
mailFolder.setDisplayName("Clutter");
mailFolder.setIsHidden(true);
MailFolder result = graphClient.me().mailFolders().post(mailFolder);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\MailFolder;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new MailFolder();
$requestBody->setDisplayName('Clutter');
$requestBody->setIsHidden(true);
$result = $graphServiceClient->me()->mailFolders()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Mail
$params = @{
displayName = "Clutter"
isHidden = $true
}
# A UPN can also be used as -UserId.
New-MgUserMailFolder -UserId $userId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.mail_folder import MailFolder
# To initialize your graph_client, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = MailFolder(
display_name = "Clutter",
is_hidden = True,
)
result = await graph_client.me.mail_folders.post(request_body)