mailFolder: importMime

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Erstellen Sie einenNicht-Nachrichtenentwurf in einem mailFolder direkt aus MIME-Inhalt, ohne ihn an den Transport zu übermitteln.

Im Gegensatz zum Erstellen einer Nachricht, bei der immer ein Entwurf erstellt wird, wird bei dieser Aktion die Nachricht in einem endgültigen, nicht entwurfsbasierten Zustand erstellt. Die Nachricht wird im Zielordner so angezeigt, als wäre sie zugestellt worden. Sie durchlaufen jedoch keinen Transport, werden nicht als gesendet gestempelt und erscheinen nie im Ordner "Gesendete Elemente ". Die Aktion behält den gesamten MIME-Inhalt bei, einschließlich Internetnachrichtenkopfzeilen, Textteile und Anlagen.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Mail-Advanced.ReadWrite Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Mail-Advanced.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

POST /me/mailFolders/{mailFolderId}/importMime
POST /users/{usersId}/mailFolders/{mailFolderId}/importMime

Hinweis: Dabei {mailFolderId} kann es sich um eine Ordner-ID oder einen bekannten Ordnernamen handeln, z. B inbox. .

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type text/plain. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext den MIME-Inhalt der Nachricht an. Geben Sie die entsprechenden Internetnachrichtenheader und den MIME-Inhalt an, alle Base64-codiert.

Der gesamte Anforderungstext besteht aus dem Base64-codierten MIME-Inhalt, ohne JSON-Umschlag oder Parameter. Diese API unterstützt nicht das individuelle Bearbeiten oder Aktualisieren von MIME-Eigenschaften.

Antwort

Bei erfolgreicher Ausführung gibt diese Aktion einen 201 Created Antwortcode und ein Nachrichtenobjekt im Antworttext zurück. Für die zurückgegebene Nachricht ist isDraft auf falsefestgelegt.

Wenn der Anforderungstext falsch formatierten MIME-Inhalt enthält, gibt diese Aktion einen 400 Bad Request Antwortcode und die folgende Fehlermeldung zurück: Invalid base64 string for MIME content.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage. Der Anforderungstext ist der Base64-codierte MIME-Inhalt, der zur besseren Lesbarkeit gekürzt wird.

POST https://graph.microsoft.com/beta/me/mailFolders/inbox/importMime
Content-type: text/plain

RnJvbTogY29udG9zby1hbGVydHNAY29udG9zby5jb20NClRvOiB0ZXN0aW5nQGNvbnRvc28uY29t
DQpTdWJqZWN0OiBRdWFydGVybHkgcmVwb3J0DQpEYXRlOiBUaHUsIDI1IEp1biAyMDI2IDEwOjAw
OjAwIC0wNzAwDQpDb250ZW50LVR5cGU6IHRleHQvcGxhaW47IGNoYXJzZXQ9InV0Zi04Ig0KDQpC
b2R5IG9mIHRoZSBpbXBvcnRlZCBtZXNzYWdlLg==

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('02d1914d-7abd-4621-a407-57b8bdeb1ada')/messages/$entity",
  "id": "AAMkADE5MWM0YmM5LThjOWUtNGFhZi1hOTBhLWNmZDBiZDhhNTljMABGAAAA",
  "createdDateTime": "2026-09-17T21:30:19Z",
  "lastModifiedDateTime": "2026-09-17T21:30:20Z",
  "receivedDateTime": "2026-09-17T21:30:20Z",
  "sentDateTime": "2026-07-24T20:03:00Z",
  "hasAttachments": false,
  "subject": "Quarterly report",
  "isRead": false,
  "isDraft": false,
  "parentFolderId": "AAMkADE5MWM0YmM5LThjOWUtNGFhZi1hOTBhLWNmZDBiZDhhNTljMAAuAAAA"
}