MailFolder erstellen
Namespace: microsoft.graph
Mit dieser API können Sie neue E-Mail-Ordner im Stammordner des Postfachs eines Benutzers erstellen.
Wenn Ein neuer Ordner ausgeblendet werden soll, müssen Sie die isHidden-Eigenschaft bei der Erstellung auf true
festlegen.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
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
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json |
Anforderungstext
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
.
Beispiel
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/v1.0/me/mailFolders
Content-type: application/json
{
"displayName": "Clutter",
"isHidden": true
}
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 201 Created
Content-type: application/json
{
"displayName": "Clutter",
"parentFolderId": "AQMkADlmOGQwZmU3LWVjOWMtNDhiYgAtODcxNy1",
"childFolderCount": 99,
"unreadItemCount": 99,
"totalItemCount": 99,
"id": "hN2Y5OGRhNGYwODEALgAAA0DAKbvJvFhJgcT3lZpkhNQBAA1",
"isHidden": true
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für