mailFolder : importMime

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Créez un message non-brouillon dans un dossier mailFolder directement à partir du contenu MIME, sans l’envoyer au transport.

Contrairement à la création d’un message, qui crée toujours un brouillon, cette action crée le message dans un état final qui n’est pas un brouillon. Le message apparaît dans le dossier de destination comme s’il avait été remis ; toutefois, il ne passe pas par le transport, n’est pas estampillé comme envoyé et n’apparaît jamais dans le dossier Éléments envoyés . L’action conserve le contenu MIME complet, y compris les en-têtes de messages Internet, les parties du corps et les pièces jointes.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) Mail-Advanced.ReadWrite Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Mail-Advanced.ReadWrite.All Non disponible.

Requête HTTP

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

Remarque : Il {mailFolderId} peut s’agir d’un ID de dossier ou d’un nom de dossier connu tel que inbox.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Content-Type text/plain. Obligatoire.

Corps de la demande

Dans le corps de la demande, indiquez le contenu MIME du message. Fournissez les en-têtes de message Internet applicables et le contenu MIME, tous codés en Base64.

L’intégralité du corps de la demande correspond au contenu MIME codé en Base64, sans enveloppe ni paramètre JSON. Cette API ne prend pas en charge la modification ou la mise à jour des propriétés MIME individuellement.

Réponse

En cas de succès, cette action renvoie un code de réponse et un 201 Created objet de message dans le corps de la réponse. Le message renvoyé a isDraft défini sur false.

Si le corps de la demande comprend du contenu MIME malveillant, cette action retourne un 400 Bad Request code de réponse et le message d’erreur suivant : Invalid base64 string for MIME content.

Exemples

Demande

L’exemple suivant illustre une demande. Le corps de la demande correspond au contenu MIME codé en Base64, raccourci pour plus de lisibilité.

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

RnJvbTogY29udG9zby1hbGVydHNAY29udG9zby5jb20NClRvOiB0ZXN0aW5nQGNvbnRvc28uY29t
DQpTdWJqZWN0OiBRdWFydGVybHkgcmVwb3J0DQpEYXRlOiBUaHUsIDI1IEp1biAyMDI2IDEwOjAw
OjAwIC0wNzAwDQpDb250ZW50LVR5cGU6IHRleHQvcGxhaW47IGNoYXJzZXQ9InV0Zi04Ig0KDQpC
b2R5IG9mIHRoZSBpbXBvcnRlZCBtZXNzYWdlLg==

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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"
}
  • Dernière mise à jour :