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 mehrere Arten von Anlagen in einem Benutzer, einer Nachricht, einer Aufgabe oder einer Gruppe, die als Basisressource für die folgenden abgeleiteten Anlagentypen dient:
- Datei (fileAttachment-Ressource)
- Ein Element (Kontakt, Ereignis oder Nachricht, dargestellt durch eine itemAttachment-Ressource )
- Link zu einer Datei (referenceAttachment-Ressource)
Sie können einem Benutzerereignis, einer Nachricht, einer Outlook-Aufgabe oder einem Gruppenbeitrag in Form einer Anlage verwandte Inhalte hinzufügen.
Achtung
Outlook-Aufgaben sind veraltet und geben am 10. August 2022 keine Daten mehr zurück. Aktualisieren Vorhandener Apps, die dieses Feature verwenden, mit Outlook-Aufgaben.
In Gruppenkalendern werden Anlagen zu Ereignissen nicht unterstützt.
Outlook-Aufgaben unterstützen keine Referenzanlagen.
Hinweis: Wenn Sie eine Datei an einen Gruppenbeitrag anfügen oder ein Element an ein Ereignis, eine Nachricht oder einen Gruppenbeitrag anfügen, beschränken 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 großer Dateien an Outlook-Nachrichten .
Methoden
Die folgenden Methoden gelten für alle abgeleiteten Typen von Anlagen (fileAttachment, itemAttachment oder referenceAttachment).
Methode | Rückgabetyp | Beschreibung |
---|---|---|
Anlage abrufen | attachment | Liest die Eigenschaften, Beziehungen oder unformatierten Inhalte einer Anlage, die an ein Benutzerereignis, eine Nachricht, eine Outlook-Aufgabe oder einen Beitrag angefügt ist. |
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. Dieser Vorgang begrenzt die Größe der Anlage, die Sie hinzufügen können, auf unter 3 MB. |
Anlagen einer Nachricht hinzufügen | attachment | Dient dem Hinzufügen einer Datei, eines Elements oder einer verknüpften Anlage zu einer Nachricht. Dieser Vorgang begrenzt die Größe der Anlage, die Sie hinzufügen können, auf unter 3 MB. |
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 Datei- oder Elementanlage hinzu. |
Anlage einem Beitrag hinzufügen | attachment | Fügen Sie eine Datei, ein Element oder eine Verknüpfungsanlage zu einem Gruppenbeitrag hinzu. Dieser Vorgang begrenzt die Größe der Anlage, die Sie hinzufügen können, auf unter 3 MB. |
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 | Ruft eine Liste von Anlagen für eine Outlook-Aufgabe ab. |
Anlagen eines Beitrags auflisten | attachment collection | Liste der Anlagen für einen Beitrag abrufen |
Löschen | Keine | Löschen sie eine Anlage für ein Ereignis, eine Nachricht, eine Outlook-Aufgabe oder einen Beitrag. |
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 zeigt den Ressourcentyp.
{
"contentType": "string",
"id": "string (identifier)",
"isInline": true,
"lastModifiedDateTime": "String (timestamp)",
"name": "string",
"size": 1024
}