MailFolder erstellen

Verwenden Sie diese API zum Erstellen eines neuen E-Mail-Ordners.

Voraussetzungen

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

HTTP-Anforderung

POST /users/{id | userPrincipalName}/mailFolders

Anforderungsheader

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

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
parentFolderId String Die Ordn-er-ID des übergeordneten Ordners oder der bekannte Ordnername Inbox, Drafts, SentItems oder DeletedItems.
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
Content-type: application/json
Content-length: 159

{
  "displayName": "displayName-value",
  "parentFolderId": "parentFolderId-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 201 Created
Content-type: application/json
Content-length: 179

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