Ressourcentyp attachment

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.

Der Basistyp für verschiedene Arten von Anlagen in einem Benutzer-, Nachrichten-, Aufgaben- oder Gruppenbeitrag, der als Basisressource für die folgenden abgeleiteten Anlagentypen dient:

Sie können verwandte Inhalte zu einem Benutzerereignis, einer Nachricht, einer Outlook-Aufgabe oder einem Gruppenbeitrag in Form einer Anlage hinzufügen.

Achtung

Outlook-Aufgaben sind veraltet und geben seit dem 10. August 2022 keine Daten mehr zurück. Aktualisieren Sie vorhandene Apps, die dieses Feature mit Outlook-Aufgaben verwenden.

In Gruppenkalendern werden Anlagen zu Ereignissen nicht unterstützt.

Outlook-Aufgaben unterstützen keine Referenzanlagen.

Hinweis: Wenn Sie eine Datei an einen Gruppenbeitrag oder ein Element an ein Ereignis, eine Nachricht oder einen Gruppenbeitrag anfügen, begrenzen Sie die Größe der Anlage auf 3 MB.

Wenn Sie eine Datei unter 3 MB anfügen, können Sie die Dateianlage einem Benutzerereignis, einer Nachricht oder einem Gruppenbeitrag hinzufügen.

Wenn Sie eine Datei zwischen 3 MB und 150 MB an ein Ereignis oder eine Nachricht anfügen, können Sie eine Uploadsitzung erstellen und iterativ Bereiche der Datei hochladen, um sie anzufügen. Ein Beispiel finden Sie unter Anfügen von großen Dateien an Outlook-Nachrichten .

Methoden

Die folgenden Methoden gelten für alle abgeleiteten Typen von Anlagen (fileAttachment, itemAttachment oder referenceAttachment).

Methode Rückgabetyp Beschreibung
Get attachment Lesen Sie die Eigenschaften, Beziehungen oder unformatierten Inhalte einer Anlage, die an ein Benutzerereignis, eine Nachricht, eine Outlook-Aufgabe oder einen Beitrag angefügt ist.
Löschen Keine Löschen Sie eine Anlage zu einem Ereignis, einer Nachricht, einer Outlook-Aufgabe oder einem Beitrag.
Anlage zu einem Benutzerereignis hinzufügen attachment Dient dem Hinzufügen einer Datei, eines Elements oder einer verknüpften Anlage zu einem Ereignis in dem Kalender eines Benutzers. Dadurch wird die Größe der Anlage, die Sie hinzufügen können, auf unter 3 MB begrenzt.
Anlagen einer Nachricht hinzufügen attachment Dient dem Hinzufügen einer Datei, eines Elements oder einer verknüpften Anlage zu einer Nachricht. Dadurch wird die Größe der Anlage, die Sie hinzufügen können, auf unter 3 MB begrenzt.
Erstellen einer Sitzung zum Anfügen einer großen Datei uploadSession Erstellen Sie eine Uploadsitzung, die es einer App ermöglicht, Bereiche einer Datei iterativ hochzuladen, um die Datei an die angegebene Nachricht oder das angegebene Ereignis anzufügen. Die Dateigröße muss zwischen 3 MB und 150 MB betragen.
Hinzufügen einer Anlage zu einer Outlook-Aufgabe (veraltet) attachment Fügen Sie einer Outlook-Aufgabe eine Anlage einer Datei oder eines Elements hinzu.
Anlage einem Beitrag hinzufügen attachment Fügen Sie einem Gruppenbeitrag eine Datei-, Element- oder Linkanlage hinzu. Dadurch wird die Größe der Anlage, die Sie hinzufügen können, auf unter 3 MB begrenzt.
Anlagen eines Benutzerereignisses auflisten attachment collection Liste der Anlagen für ein Ereignis in einem Benutzerkalender abrufen.
Anlagen einer Nachricht auflisten attachment collection Liste der Anlagen für eine Nachricht abrufen
Auflisten von Anlagen einer Outlook-Aufgabe (veraltet) attachment-Sammlung Abrufen einer Liste von Anlagen für eine Outlook-Aufgabe.
Anlagen eines Beitrags auflisten attachment collection Liste der Anlagen für einen Beitrag abrufen

Eigenschaften

Nachfolgend finden Sie die grundlegenden Eigenschaften von attachment-Ressourcen. Zusätzliche Eigenschaften finden Sie bei dem jeweiligen Anlagentyp (fileAttachment, itemAttachment oder referenceAttachment).

Eigenschaft Typ Beschreibung
contentType String Der MIME-Typ.
id Zeichenfolge Schreibgeschützt.
isInline Boolean true, wenn die Anlage eine Inlineanlage ist, andernfalls false.
lastModifiedDateTime DateTimeOffset Der Typ „Zeitstempel“ stellt die Datums- und Uhrzeitinformationen im Format der ISO 8601 dar und gibt immer die UTC an. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
name String Der Anzeigename der Anlage. Dies muss nicht der tatsächliche Dateiname sein.
size Int32 Die Länge der Anlage in Byte.

Beziehungen

Keine

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "contentType": "string",
  "id": "string (identifier)",
  "isInline": true,
  "lastModifiedDateTime": "String (timestamp)",
  "name": "string",
  "size": 1024
}