Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Weiterleiten einer Nachricht im JSON- oder MIME-Format.
Wenn Sie das JSON-Format verwenden, können Sie:
- Geben Sie entweder einen Kommentar oder die body-Eigenschaft des
messageParameters an. Wenn Sie beide angeben, wird der Fehler HTTP 400 Bad Request zurückgegeben. - Geben Sie entweder den
toRecipientsParameter oder die toRecipients-Eigenschaft desmessageParameters an. Wenn Sie beide oder keines von beiden angeben, wird ein HTTP 400-Fehler vom Typ "Ungültige Anforderung" zurückgegeben.
Bei Verwendung des MIME-Formats:
- Geben Sie die entsprechenden Internetnachrichtenkopfzeilen und den MIME-Inhalt an, die im Anforderungstext alle im Base64-Format codiert sind.
- Fügen Sie dem MIME-Inhalt sämtliche Anlagen und S/MIME-Eigenschaften hinzu.
Bei dieser Methode wird die Nachricht im Ordner Gesendete Elemente gespeichert.
Erstellen Sie alternativ einen Entwurf, um eine Nachricht weiterzuleiten, und senden Sie sie später.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
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.Send | Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) | Mail.Send | Nicht verfügbar. |
| Anwendung | Mail.Send | Nicht verfügbar. |
HTTP-Anforderung
POST /me/messages/{id}/forward
POST /users/{id | userPrincipalName}/messages/{id}/forward
POST /me/mailFolders/{id}/messages/{id}/forward
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/forward
Anforderungsheader
| Name | Typ | Beschreibung |
|---|---|---|
| Authorization | string | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Content-Type | string | Die Art der Daten im Textkörper einer Entität. Erforderlich. Verwenden Sie application/json für ein JSON-Objekt und text/plain für MIME-Inhalt. |
Anforderungstext
Geben Sie bei Verwendung des JSON-Formats ein JSON-Objekt mit den folgenden Parametern an.
| Parameter | Typ | Beschreibung |
|---|---|---|
| comment | String | Ein Kommentar, der eingefügt werden kann. Kann eine leere Zeichenfolge sein. |
| toRecipients | recipient collection | Die Liste der Empfänger. |
| message | Nachricht | Alle beschreibbaren Eigenschaften, die in der Antwortnachricht aktualisiert werden sollen. |
Geben Sie bei der Angabe des Texts im MIME-Format den MIME-Inhalt mit den entsprechenden Internetnachrichtenkopfzeilen ("An", "CC", "BCC", "Betreff") an, die alle im Anforderungstext im base64-Format codiert sind.
Antwort
Wenn die Methode erfolgreich verläuft, wird der Antwortcode 202 Accepted zurückgegeben. Es gibt nichts im Antworttext zurück.
Wenn der Anforderungstext falsch formatierten MIME-Inhalt enthält, gibt diese Methode 400 Bad request sowie die folgende Fehlermeldung an: „Ungültige Base64-Zeichenfolge für MIME-Inhalt“.
Beispiele
Beispiel 1: Weiterleiten einer Nachricht im JSON-Format
Im folgenden Beispiel wird die isDeliveryReceiptRequested-Eigenschaft auf true festgelegt, ein Kommentar hinzugefügt und die Nachricht weitergeleitet.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAH5JaLAAA=/forward
Content-Type: application/json
{
"message":{
"isDeliveryReceiptRequested": true,
"toRecipients":[
{
"emailAddress": {
"address":"danas@contoso.com",
"name":"Dana Swope"
}
}
]
},
"comment": "Dana, just want to make sure you get this."
}
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 202 Accepted
Beispiel 2: Weiterleiten einer Nachricht im MIME-Format
POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAH5JaLAAA=/forward
Content-Type: text/plain
Q29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9wa2NzNy1taW1lOw0KCW5hbWU9c21pbWUucDdtOw0KCXNtaW1lLXR5cGU9ZW52ZWxvcGVkLWRhdGENCk1pbWUtVmVyc2lvbjogMS4wIChNYWMgT1MgWCBNYWlsIDEzLjAgXCgzNjAxLjAuMTBcKSkNClN1YmplY3Q6IFJlOiBUZXN0aW5nIFMvTUlNRQ0KQ29udGVudC1EaXNwb3Np...
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 202 Accepted
Wenn der Anforderungstext falsch formatierten MIME-Inhalt enthält, gibt diese Methode die folgende Fehlermeldung an.
HTTP/1.1 400 Bad Request
Content-type: application/json
{
"error": {
"code": "ErrorMimeContentInvalidBase64String",
"message": "Invalid base64 string for MIME content."
}
}