Postfacheinstellungen des Benutzers abrufenGet user mailbox settings

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Rufen Sie die mailboxSettings des Benutzers ab.Get the user's mailboxSettings. Sie können alle Postfacheinstellungen anzeigen oder bestimmte Einstellungen abrufen.You can view all mailbox settings, or get specific settings.

Benutzer können die folgenden Einstellungen für Ihre Postfächer über einen Outlook-Client festlegen:Users can set the following settings for their mailboxes through an Outlook client:

Benutzer können ihre bevorzugten Datums- und Uhrzeitformate mit Outlook im Web festlegen.Users can set their preferred date and time formats using Outlook on the web. Benutzer können eines der unterstützten Kurzes Datum- oder Kurze Uhrzeit-Formate aussuchen.Users can choose one of the supported short date or short time formats. Dieser GET-Vorgang gibt das vom Benutzer ausgesuchte Format zurück.This GET operation returns the format the user has chosen.

Benutzer können die in einem Outlook-Clienten bevorzugte Zeitzone festlegen, indem Sie unter den unterstützten Zeitzonen auswählen, die Ihr Administrator für ihren Postfachserver eingerichtet hat.Users can set the time zone they prefer on any Outlook client, by choosing from the supported time zones that their administrator has set up for their mailbox server. Der Administrator kann Zeitzonen im Windows-Zeitzonenformat oder im IANA-Format (Internet Assigned Numbers Authority) (auch als Olson-Zeitzone bezeichnet) einrichten.The administrator can set up time zones in the Windows time zone format or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. Das Windows-Format ist die Standardeinstellung.The Windows format is the default.

Dieser GET-Vorgang gibt die bevorzugte Zeitzone des Benutzers in dem vom Administrator eingerichteten Format zurück.This GET operation returns the user's preferred time zone in the format that the administrator has set up. Wenn Sie diese Zeitzone in einem bestimmten Format (Windows oder IANA) abrufen möchten, können Sie zunächst die bevorzugte Zeitzone in das entsprechende Format als Postfacheinstellung ändern.If you want that time zone to be in a specific format (Windows or IANA), you can first update the preferred time zone in that format as a mailbox setting. Anschließend können Sie die Zeitzone in diesem Format abrufen.Subsequently you will be able to get the time zone in that format. Alternativ können Sie die Formatkonvertierung separat in Ihrer App verwalten.Alternatively, you can manage the format conversion separately in your app.

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.Read, MailboxSettings.ReadWriteMailboxSettings.Read, MailboxSettings.ReadWrite
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) MailboxSettings.Read, MailboxSettings.ReadWriteMailboxSettings.Read, MailboxSettings.ReadWrite
AnwendungApplication MailboxSettings.Read, MailboxSettings.ReadWriteMailboxSettings.Read, MailboxSettings.ReadWrite

HTTP-AnforderungHTTP request

So rufen Sie alle Postfacheinstellungen für einen Benutzer ab:To get all the mailbox settings for a user:

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

Verwenden Sie die folgende Anforderung, um bestimmte Einstellungen abzurufen: Einstellungen für automatische Antworten, Datumsformat, Gebietsschema, Zeitformat, Zeitzone oder Geschäftszeiten:To get specific settings - only the automatic replies settings, date format, locale, time format, time zone, or working hours:

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

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt einige der OData-Abfrageparameter zur Anpassung der Antwort.This method supports some of the OData Query Parameters to help customize the response.

AnforderungsheaderRequest headers

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

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eines der folgenden angeforderten Objekte im Antworttext zurückgegeben:If successful, this method returns a 200 OK response code and one of the following requested objects in the response body:

BeispieleExamples

Beispiel 1Example 1

AnforderungRequest

Im ersten Beispiel werden alle Postfacheinstellungen des Postfachs des angemeldeten Benutzers abgerufen, die Einstellungen für automatische Antworten, Datumsformat, Gebietsschema (Sprache und Land/Region), Zeitformat, Zeitzone sowie Geschäftszeiten umfassen.The first example gets all the mailbox settings of the signed-in user's mailbox, which include settings for automatic replies, date format, locale (language and country/region), time format, time zone, and working hours.

GET https://graph.microsoft.com/beta/me/mailboxSettings

AntwortResponse

Die Antwort umfasst alle Postfacheinstellungen des angemeldeten Benutzers.The response includes all the mailbox settings of the signed-in user. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.Note: The response object shown here may be truncated for brevity. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.All of the properties will be returned from an actual call.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$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"
        }
    },
    "dateFormat": "MM/dd/yyyy",
    "timeFormat": "hh:mm tt",
    "delegateMeetingMessageDeliveryOptions": "sendToDelegateOnly"
}

Beispiel 2Example 2

AnforderungRequest

Im zweiten Beispiel werden die Einstellungen für automatische Antworten für das Postfach des angemeldeten Benutzers abgerufen.The second example gets specifically the automatic replies settings of the signed-in user's mailbox.

GET https://graph.microsoft.com/beta/me/mailboxSettings/automaticRepliesSetting

AntwortResponse

Die Antwort enthält nur die Einstellungen für automatische Antworten. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.The response includes only the automatic replies settings. 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 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$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"
}

Beispiel 3Example 3

AnforderungRequest

Im dritten Beispiel werden die Einstellungen für die Geschäftszeiten für das Postfach des angemeldeten Benutzers abgerufen.The third example gets specifically the working hour settings of the signed-in user's mailbox.

GET https://graph.microsoft.com/beta/me/mailboxSettings/workingHours

AntwortResponse

Die Antwort enthält nur die Einstellungen für Geschäftszeiten.The response includes only the working hours settings. Beachten Sie, dass sich die Geschäftszeiten des Benutzers in einer benutzerdefinierten Zeitzone befinden.Notice that the user's work hours are in a custom time zone. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.Note: The response object shown here may be truncated for brevity. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.All of the properties will be returned from an actual call.

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

{
    "@odata.context":"https://graph.microsoft.com/beta/$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
        }
    }
}