フィードバック 編集

user: getMailTips

  • [アーティクル]

名前空間: microsoft.graph

サインインしているユーザーが使用できる 1 つ以上の受信者のメール ヒントを取得 します。

アクションを呼び出 POST して getMailTips 、複数の受信者に対して一度に返されるメール ヒントの特定の種類を要求できます。 要求されたメール ヒントは、 mailTips コレクションに返 されます。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) Mail.Read、Mail.Read.Shared
委任 (個人用 Microsoft アカウント) Mail.Read
アプリケーション Mail.Read

HTTP 要求

POST /me/getMailTips
POST /users/{id|userPrincipalName}/getMailTips

オプションのクエリ パラメーター

このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。必須。
Content-Type application/json

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

プロパティ 種類 説明
EmailAddresses String コレクション メール ヒントを取得する受信者の SMTP アドレスのコレクションです。
MailTipsOptions 文字列 要求されたメール ヒントを表すフラグの列挙。 使用できる値は automaticReplies、、 customMailTip、 deliveryRestriction、 externalMemberCount、 mailboxFullStatus、 maxMessageSize、 moderationStatus、 recipientScope、 recipientSuggestionsです totalMemberCount。

応答

成功した場合、このメソッドは応答 200 OK コードと、応答本文の mailTips オブジェクトのコレクションを返します。

例

要求

次の例では、自動返信設定とメールボックスの完全な状態について、指定した受信者のメール ヒントを取得します。

POST https://graph.microsoft.com/v1.0/me/getMailTips
Content-Type: application/json

{
    "EmailAddresses": [
        "danas@contoso.onmicrosoft.com", 
        "fannyd@contoso.onmicrosoft.com"
    ],
    "MailTipsOptions": "automaticReplies, mailboxFullStatus"
}
応答

以下に応答の例を示します。注: ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。

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.onmicrosoft.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.onmicrosoft.com"
            },
            "automaticReplies":{
                "message":""
            },
            "mailboxFull":false
        }
    ]
}