Получение параметров почтового ящика пользователя

Статья
03/15/2024

Пространство имен: microsoft.graph

Получение объекта mailboxSettings пользователя. Вы можете просмотреть все параметры почтового ящика или получить определенные параметры.

Пользователи могут настраивать указанные ниже параметры для своих почтовых ящиков с помощью клиента Outlook:

автоматические ответы (автоматическое уведомление пользователей при получении их почты);
формат даты;
delegateMeetingMessageDeliveryOptions
языковой стандарт (язык и страну или регион);
формат времени;
часовой пояс;
рабочее время.
назначение пользователя

С помощью Outlook в Интернете пользователи могут настраивать предпочитаемый формат даты и времени. Пользователи могут выбрать один из поддерживаемых кратких форматов даты или кратких форматов времени. Эта операция GET возвращает формат, выбранный пользователем.

Пользователи могут настроить нужный часовой пояс в любом клиенте Outlook, выбрав из поддерживаемых часовых поясов, настроенных администратором для почтового сервера. Администратор может настроить часовые пояса в формате часового пояса Windows или в формате часового пояса IANA (также известного как часовой пояс Олсона). Формат Windows используется по умолчанию.

Эта операция GET возвращает предпочитаемый пользователем часовой пояс в формате, настроенном администратором. Чтобы задать определенный формат часового пояса (Windows или IANA), сначала обновите предпочтительный часовой пояс в этом формате как параметр почтового ящика. Затем вы сможете получить часовой пояс в этом формате. Кроме того, вы можете управлять преобразованием форматов в своем приложении.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	MailboxSettings.Read	MailboxSettings.ReadWrite
Делегированные (личная учетная запись Майкрософт)	MailboxSettings.Read	MailboxSettings.ReadWrite
Для приложений	MailboxSettings.Read	MailboxSettings.ReadWrite

HTTP-запрос

Получение всех параметров почтового ящика пользователя:

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

Чтобы получить определенные параметры, — только параметры автоматических ответов, формат даты, языковой стандарт, формат времени, часовой пояс, рабочее время или тип получателя или почтового ящика пользователя (например, назначение пользователя):

GET /me/mailboxSettings/automaticRepliesSetting
GET /users/{id|userPrincipalName}/mailboxSettings/automaticRepliesSetting

GET /me/mailboxSettings/dateFormat
GET /users/{id|userPrincipalName}/mailboxSettings/dateFormat

GET /me/mailboxSettings/delegateMeetingMessageDeliveryOptions
GET /users/{id|userPrincipalName}/mailboxSettings/delegateMeetingMessageDeliveryOptions

GET /me/mailboxSettings/language
GET /users/{id|userPrincipalName}/mailboxSettings/language

GET /me/mailboxSettings/timeFormat
GET /users/{id|userPrincipalName}/mailboxSettings/timeFormat

GET /me/mailboxSettings/timeZone
GET /users/{id|userPrincipalName}/mailboxSettings/timeZone

GET /me/mailboxSettings/workingHours
GET /users/{id|userPrincipalName}/mailboxSettings/workingHours

GET /me/mailboxSettings/userPurpose
GET /users/{id|userPrincipalName}/mailboxSettings/userPurpose

Необязательные параметры запросов

Этот метод поддерживает некоторые параметры запросов OData для настройки отклика.

Заголовки запросов

Имя	Тип	Описание
Authorization	string	Bearer {token}. Обязательно.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

При успешном выполнении этот метод возвращает код отклика 200 OK и один из указанных ниже запрошенных объектов в тексте отклика.

Объект mailboxSettings.
Объект automaticRepliesSetting.
Строка (для параметра dateFormat).
string (для delegateMeetingMessageDeliveryOptions)
Объект localeInfo.
Строка (для параметра timeFormat).
Строка (для параметра timeZone).
workingHours
userPurpose

Примеры

Пример 1. Получение всех параметров почтового ящика вошедшего пользователя

Получите все параметры почтового ящика вошедшего пользователя, включая параметры для автоматических ответов, формата даты, языкового стандарта (язык и страна или регион), формата времени, часового пояса, рабочего времени и назначения пользователя.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/me/mailboxSettings


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.MailboxSettings.GetAsync();


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc users mailbox-settings get --user-id {user-id}



import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



mailboxSettings, err := graphClient.Me().MailboxSettings().Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

MailboxSettings result = graphClient.me().mailboxSettings().get();


const options = {
	authProvider,
};

const client = Client.init(options);

let mailboxSettings = await client.api('/me/mailboxSettings')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->me()->mailboxSettings()->get()->wait();


Import-Module Microsoft.Graph.Users

# A UPN can also be used as -UserId.
Get-MgUserMailboxSetting -UserId $userId


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


result = await graph_client.me.mailbox_settings.get()

Отклик

Ниже приведен пример ответа, который включает все параметры почтового ящика пользователя, выполнившего вход.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Me/mailboxSettings",
    "automaticRepliesSetting": {
        "status": "Scheduled",
        "externalAudience": "All",
        "scheduledStartDateTime": {
            "dateTime": "2016-03-14T07:00:00.0000000",
            "timeZone": "UTC"
        },
        "scheduledEndDateTime": {
            "dateTime": "2016-03-28T07: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)"
    },
    "workingHours":{
        "daysOfWeek":[
            "monday",
            "tuesday",
            "wednesday",
            "thursday",
            "friday"
        ],
        "startTime": "08:00:00.0000000",
        "endTime": "17:00:00.0000000",
        "timeZone":{
            "name":"Pacific Standard Time"
        }
    },
    "userPurpose": {
        "value": "user"
    },
    "dateFormat": "MM/dd/yyyy",
    "timeFormat": "hh:mm tt",
    "delegateMeetingMessageDeliveryOptions": "sendToDelegateOnly"
}

Пример 2. Получение параметров автоматических ответов почтового ящика вошедшего пользователя

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/me/mailboxSettings/automaticRepliesSetting

Snippet not available

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let automaticRepliesSetting = await client.api('/me/mailboxSettings/automaticRepliesSetting')
	.get();

Snippet not available

Snippet not available

Snippet not available

Отклик

Ниже приведен пример ответа, который включает только параметры автоматических ответов.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Me/mailboxSettings/automaticRepliesSetting",
    "status": "alwaysEnabled",
    "externalAudience": "None",
    "scheduledStartDateTime": {
        "dateTime": "2016-03-19T02:00:00.0000000",
        "timeZone": "UTC"
    },
    "scheduledEndDateTime": {
        "dateTime": "2016-03-20T02: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"
}

Пример 3. Получение параметров рабочего времени почтового ящика пользователя, выполнившего вход

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/me/mailboxSettings/workingHours

Snippet not available

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let workingHours = await client.api('/me/mailboxSettings/workingHours')
	.get();

Snippet not available

Snippet not available

Snippet not available

Отклик

Ниже приведен пример ответа, который включает только параметры рабочего времени. Обратите внимание, что рабочее время пользователя относится к пользовательскому часовому поясу.

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

{
    "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#users('94447c6e-ea4c-494c-a9ed-d905e366c5cb')/mailboxSettings/workingHours",
    "daysOfWeek":[
        "monday",
        "tuesday",
        "wednesday",
        "thursday",
        "friday",
        "saturday"
    ],
    "startTime":"09:00:00.0000000",
    "endTime":"18:30:00.0000000",
    "timeZone":{
        "@odata.type":"#microsoft.graph.customTimeZone",
        "bias":-200,
        "name":"Customized Time Zone",
        "standardOffset":{
            "time":"02:00:00.0000000",
            "dayOccurrence":4,
            "dayOfWeek":"sunday",
            "month":5,
            "year":0
        },
        "daylightOffset":{
            "daylightBias":-100,
            "time":"02:00:00.0000000",
            "dayOccurrence":2,
            "dayOfWeek":"sunday",
            "month":10,
            "year":0
        }
    }
}

Пример 4. Получение конкретных параметров назначения пользователя почтового ящика вошедшего пользователя

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/me/mailboxSettings/userPurpose

Snippet not available

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let userPurpose = await client.api('/me/mailboxSettings/userPurpose')
	.get();

Snippet not available

Snippet not available

Snippet not available

Отклик

Ниже приведен пример ответа, который включает только параметры назначения пользователя .

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('622eaaff-0683-4862-9de4-f2ec83c2bd98')/mailboxSettings/userPurpose",
    "value": "user"
}

Получение параметров почтового ящика пользователя

Разрешения

HTTP-запрос

Необязательные параметры запросов

Заголовки запросов

Текст запроса

Отклик

Примеры

Пример 1. Получение всех параметров почтового ящика вошедшего пользователя

Запрос

Отклик

Пример 2. Получение параметров автоматических ответов почтового ящика вошедшего пользователя

Запрос

Отклик

Пример 3. Получение параметров рабочего времени почтового ящика пользователя, выполнившего вход

Запрос

Отклик

Пример 4. Получение конкретных параметров назначения пользователя почтового ящика вошедшего пользователя

Запрос

Отклик

Обратная связь

Обратная связь

Дополнительные ресурсы