message: forward
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
message
Parameters an. Wenn Sie beide angeben, wird der Fehler HTTP 400 Bad Request zurückgegeben. - Geben Sie entweder den
toRecipients
Parameter oder die toRecipients-Eigenschaft desmessage
Parameters 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.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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. |
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."
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für