MailFolder erstellen

Verwenden Sie diese API zum Erstellen eines neuen MailFolder.

Voraussetzungen

Einer der folgenden Bereiche ist erforderlich, um diese API auszuführen: Mail.ReadWrite

HTTP-Anforderung

POST /me/mailFolders/{id}/childFolders
POST /users/{id | userPrincipalName}/mailFolders/{id}/childFolders

Geben Sie den übergeordneten Ordner in der Abfrage-URL als Ordner-ID an oder den bekannten Ordnernamen Inbox, Drafts, SentItems oder DeletedItems.

Anforderungsheader

Kopfzeile Wert
Authorization Bearer . Required.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an. displayName ist die einzige schreibbare Eigenschaft für ein MailFolder-Objekt.

Parameter Typ Beschreibung
displayName String Der Anzeigename für den neuen Ordner.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 201, Created und das MailFolder-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/v1.0/me/mailFolders/{id}/childFolders
Content-type: application/json
Content-length: 159

{
  "displayName": "displayName-value",
}
Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 179

{
  "displayName": "displayName-value",
  "parentFolderId": "parentFolderId-value",
  "childFolderCount": 99,
  "unreadItemCount": 99,
  "totalItemCount": 99,
  "id": "id-value"
}