message: forward
Namespace: microsoft.graph
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
Wenn Sie das JSON-Format verwenden, geben Sie ein JSON-Objekt im Anforderungstext 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. |
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
Hier sehen Sie ein Beispiel für das Aufrufen dieser API.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/v1.0/me/messages/{id}/forward
Content-type: application/json
{
"comment": "comment-value",
"toRecipients": [
{
"emailAddress": {
"name": "name-value",
"address": "address-value"
}
}
]
}
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 202 Accepted
Beispiel 2: Weiterleiten einer Nachricht mit MIME-Inhalt
Anforderung
POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/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