Anlagen auflisten

  • Artikel

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.

Mit dieser API können Sie eine Liste der einer Nachricht angefügten Objekte des Typs attachment abrufen.

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.Read
Delegiert (persönliches Microsoft-Konto) Mail.Read
Anwendung Mail.Read

HTTP-Anforderung

Anlagen für eine Nachricht im Postfach eines Benutzers.

GET /me/messages/{id}/attachments
GET /users/{id | userPrincipalName}/messages/{id}/attachments

Anlagen für eine Nachricht in einem MailFolder der obersten Ebene im Postfach eines Benutzers.

GET /me/mailFolders/{id}/messages/{id}/attachments
GET /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/attachments

Anlagen für eine Nachricht , die in einem untergeordneten Ordner eines mailFolder-Ordners im Postfach eines Benutzers enthalten ist. Das folgende Beispiel zeigt eine Ebene der Schachtelung, aber eine Nachricht kann sich in einem untergeordneten Element eines untergeordneten Elements befinden usw.

GET /me/mailFolders/{id}/childFolders/{id}/.../messages/{id}/attachments/{id}
GET /users/{id | userPrincipalName}/mailFolders/{id}/childFolders/{id}/messages/{id}/attachments/{id}

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.

Insbesondere können Sie den Abfrageparameter $expand verwenden, um alle Nachrichtenanlagen inline mit den restlichen Nachrichteneigenschaften einzuschließen. Zum Beispiel:

GET https://graph.microsoft.com/beta/me/messages/{id}?$expand=attachments

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eine Sammlung von Attachment-Objekten im Antworttext zurückgegeben.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/me/messages/{id}/attachments
Antwort

Das folgende Beispiel zeigt die Antwort. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt sein.

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

{
  "value": [
    {
      "@odata.type": "microsoft.graph.fileAttachment",
      "contentType": "contentType-value",
      "contentLocation": "contentLocation-value",
      "contentBytes": "contentBytes-value",
      "contentId": "null",
      "lastModifiedDateTime": "2016-10-19T10:37:00Z",
      "id": "id-value",
      "isInline": false,
      "isContactPhoto": false,
      "name": "name-value",
      "size": 99
    }
  ]
}