user: getMailTips
Namespace: microsoft.graph
Rufen Sie die E-Mail-Infos eines oder mehrerer Empfänger als für den angemeldeten Benutzer verfügbar ab.
Beachten Sie, dass Sie durch einen POST
Aufruf der getMailTips
Aktion anfordern können, dass bestimmte Typen von E-Mail-Infos für mehrere Empfänger gleichzeitig zurückgegeben werden. Die angeforderten E-Mail-Infos werden in einer MailTips-Sammlung zurückgegeben.
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.Read | Mail.Read.Shared |
Delegiert (persönliches Microsoft-Konto) | Mail.Read | Nicht verfügbar. |
Anwendung | Mail.Read | Nicht verfügbar. |
HTTP-Anforderung
POST /me/getMailTips
POST /users/{id|userPrincipalName}/getMailTips
Optionale Abfrageparameter
Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json |
Anforderungstext
Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.
Eigenschaft | Typ | Beschreibung |
---|---|---|
EmailAddresses | String collection | Eine Sammlung von SMTP-Adressen von Empfängern, für die E-Mail-Infos abgerufen werden sollen. |
MailTipsOptions | String | Eine Enumeration von Flags, die die angeforderten E-Mail-Infos darstellt. Mögliche Werte sind: automaticReplies , customMailTip , deliveryRestriction , externalMemberCount , mailboxFullStatus , maxMessageSize , moderationStatus , recipientScope , recipientSuggestions und totalMemberCount . |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK
Antwortcode und eine Auflistung von mailTips-Objekten im Antworttext zurück.
Beispiel
Anforderung
Im folgenden Beispiel werden E-Mail-Infos für die angegebenen Empfänger, für alle Einstellungen für automatische Antworten und für das Postfach status abgerufen.
POST https://graph.microsoft.com/v1.0/me/getMailTips
Content-Type: application/json
{
"EmailAddresses": [
"danas@contoso.com",
"fannyd@contoso.com"
],
"MailTipsOptions": "automaticReplies, mailboxFullStatus"
}
Antwort
Das folgende Beispiel zeigt die Antwort. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt sein.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.mailTips)",
"value":[
{
"emailAddress":{
"name":"",
"address":"danas@contoso.com"
},
"automaticReplies":{
"message":"<style type=\"text/css\" style=\"\">\r\n<!--\r\np\r\n\t{margin-top:0;\r\n\tmargin-bottom:0}\r\n-->\r\n</style>\r\n<div dir=\"ltr\">\r\n<div id=\"x_divtagdefaultwrapper\" style=\"font-size:12pt; color:#000000; background-color:#FFFFFF; font-family:Calibri,Arial,Helvetica,sans-serif\">\r\n<p>Hi, I am on vacation right now. I'll get back to you after I return.<br>\r\n</p>\r\n</div>\r\n</div>",
"messageLanguage":{
"locale":"en-US",
"displayName":"English (United States)"
},
"scheduledStartTime": {
"dateTime": "2018-08-07T02:00:00.0000000",
"timeZone": "UTC"
},
"scheduledEndTime": {
"dateTime": "2018-08-09T02:00:00.0000000",
"timeZone": "UTC"
}
},
"mailboxFull":false
},
{
"emailAddress":{
"name":"",
"address":"fannyd@contoso.com"
},
"automaticReplies":{
"message":""
},
"mailboxFull":false
}
]
}