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 des message 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."
    }
}