Regel erstellenCreate rule

Erstellen Sie ein messageRule-Objekt, indem Sie eine Gruppe von Bedingungen und Aktionen angeben.Create a messageRule object by specifying a set of conditions and actions.

Outlook führt diese Aktionen aus, wenn eine eingehende Nachricht im Posteingang des Benutzers die angegebenen Bedingungen erfüllt.Outlook carries out those actions if an incoming message in the user's Inbox meets the specified conditions.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) MailboxSettings.ReadWriteMailboxSettings.ReadWrite
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) MailboxSettings.ReadWriteMailboxSettings.ReadWrite
AnwendungApplication MailboxSettings.ReadWriteMailboxSettings.ReadWrite

HTTP-AnforderungHTTP request

POST /me/mailFolders/inbox/messageRules
POST /users/{id | userPrincipalName}/mailFolders/inbox/messageRules

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie im Anforderungstext die Parameter an, die auf die Regel angewendet werden können.In the request body, supply the parameters that are applicable to your rule. Nachfolgend finden Sie die Textparameter, die in der Regel beim Erstellen von Regeln verwendet werden.The following are body parameters that are typically used when creating rules. Sie können bei Bedarf im Anforderungstext beliebige andere schreibbare messageRule-Eigenschaften angeben.You can specify any other writable messageRule properties as appropriate in the request body.

NameName TypType BeschreibungDescription
Aktionenactions messageRuleActionsmessageRuleActions Aktionen, die auf eine Nachricht angewendet werden, wenn die entsprechenden Bedingungen (falls vorhanden) erfüllt sind.Actions to be taken on a message when the corresponding conditions, if any, are fulfilled. Erforderlich.Required.
Bedingungenconditions messageRulePredicatesmessageRulePredicates Bedingungen, die bei Erfüllung die entsprechenden Aktionen für diese Regel auslösen.Conditions that when fulfilled, will trigger the corresponding actions for that rule. Optional.Optional.
displayNamedisplayName StringString Der Anzeigename der Regel.The display name of the rule. Erforderlich.Required.
Ausnahmenexceptions messageRulePredicatesmessageRulePredicates Ausnahmebedingungen für die Regel.Represents exception conditions for the rule. Optional.Optional.
isEnabledisEnabled Boolescher WertBoolean Gibt an, ob die Regel auf Nachrichten angewendet werden kann.Indicates whether the rule is enabled to be applied to messages. Optional.Optional.
sequencesequence Int32Int32 Gibt die Reihenfolge an, in der die Regel zusammen mit anderen Regeln ausgeführt wird.Indicates the order in which the rule is executed, among other rules. Erforderlich. Required.

AntwortResponse

Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 201 Created und ein Objekt des Typs messageRule im Antworttext zurück.If successful, this method returns 201 Created response code and a messageRule object in the response body.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

POST https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messageRules
Content-type: application/json

{      
    "displayName": "From partner",      
    "sequence": 2,      
    "isEnabled": true,          
    "conditions": {
        "senderContains": [
          "adele"       
        ]
     },
     "actions": {
        "forwardTo": [
          {
             "emailAddress": {
                "name": "Alex Wilbur",
                "address": "AlexW@contoso.onmicrosoft.com"
              }
           }
        ],
        "stopProcessingRules": true
     }    
}

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-type: application/json

{
  "id":"AQAAAJ5dZqA=",
  "displayName":"From partner",
  "sequence":2,
  "isEnabled":true,
  "hasError":false,
  "isReadOnly":false,
  "conditions":{
    "senderContains":[
      "ADELE"
    ]
  },
  "actions":{
      "stopProcessingRules":true,
      "forwardTo":[
        {
          "emailAddress":{
            "name":"Alex Wilbur",
            "address":"AlexW@contoso.onmicrosoft.com"
          }
        }
      ]
  }
}