ユーザーのメールボックスの設定を更新する

ユーザーのメールボックスの 1 つ以上の設定を更新します。これには、自動応答 (ユーザーが電子メールを受信したときに自動的にユーザーに通知)、ロケール、またはタイム ゾーンの設定が含まれます。

これらの設定の 1 つ以上を、mailboxSettingsの一部として有効化、構成、または無効化できます。

メールボックス設定は作成または削除できません。

前提条件

この API を実行するには、以下のスコープが必要です。Mailboxsettings.ReadWrite

HTTP 要求

PATCH /me/mailboxSettings
PATCH /users/{id|userPrincipalName}/mailboxSettings

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

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

要求ヘッダー

名前 説明
Authorization string Bearer <token>. Required.

要求本文

要求本文で、更新する関連プロパティの値を指定します。要求本文に含まれない既存のプロパティは、以前の値のままになるか、他のプロパティ値の変化に基づいて再計算されます。最適なパフォーマンスを得るためには、変更されていない既存の値を含めないでください。書き込み可能または更新可能なプロパティを次に示します。

プロパティ 説明
automaticRepliesSetting automaticRepliesSetting サインイン ユーザーからのメッセージを使用して、着信メールの送信者に自動的に通知する構成設定。
language localeInfo 優先言語および国/地域を含むユーザーのロケール情報。
timeZone string ユーザーのメールボックスの既定のタイム ゾーン。

応答

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

要求

次の例では、automaticRepliesSetting プロパティの statusscheduledStartDateTime および scheduledEndDateTime プロパティを設定することにより、日付の範囲の自動応答を有効にします。

PATCH https://graph.microsoft.com/api/v1.0/me/mailboxSettings
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/api/v1.0/$metadata#Me/mailboxSettings",
    "automaticRepliesSetting": {
        "status": "Scheduled",
        "scheduledStartDateTime": {
          "dateTime": "2016-03-20T18:00:00.0000000",
          "timeZone": "UTC"
        },
        "scheduledEndDateTime": {
          "dateTime": "2016-03-28T18:00:00.0000000",
          "timeZone": "UTC"
        }
    }
}
応答

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/api/v1.0/$metadata#Me/mailboxSettings",
    "automaticRepliesSetting": {
        "status": "scheduled",
        "externalAudience": "none",
        "scheduledStartDateTime": {
            "dateTime": "2016-03-20T02:00:00.0000000",
            "timeZone": "UTC"
        },
        "scheduledEndDateTime": {
            "dateTime": "2016-03-28T02:00:00.0000000",
            "timeZone": "UTC"
        },
    "internalReplyMessage": "<html>\n<body>\n<p>I'm at our company's worldwide reunion and will respond to your message as soon as I return.<br>\n</p></body>\n</html>\n",
    "externalReplyMessage": "<html>\n<body>\n<p>I'm at the Contoso worldwide reunion and will respond to your message as soon as I return.<br>\n</p></body>\n</html>\n"
    },
    "timeZone":"UTC",
    "language":{
      "locale":"en-US",
      "displayName":"English (United States)"
    }
}