Postfacheinstellungen des Benutzers abrufenGet user mailbox settings

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. Dies umfasst Einstellungen für automatische Antworten (Personen automatisch nach Erhalt Ihrer e-Mail benachrichtigen), das Gebietsschema (Sprache und Land/Region), die Zeitzone und die Arbeitszeiten.This includes settings for automatic replies (notify people automatically upon receipt of their email), locale (language and country/region), time zone, and working hours.

Sie können alle Postfacheinstellungen anzeigen oder bestimmte Einstellungen abrufen.You can view all mailbox settings, or, get specific settings.

Zeitzone ist eine bevorzugte Einstellung, die ein Benutzer für das Benutzerpostfach einrichten kann.Time zone is one of the preferred settings a user can set up for the user's mailbox. Der Benutzer wählt ihn aus den unterstützten Zeitzonen aus, die ein Administrator für den Postfachserver des Benutzers eingerichtet hat.The user chooses it from the supported time zones that an administrator has set up for the user's mailbox server. Der Administrator richtet Zeitzonen im Windows-Zeit Zonen Format oder in der IANA-Zeitzone (Internet Assigned Numbers Authority ) (auch als Olson-Zeitzone bezeichnet) ein.The administrator sets 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.

Wenn Sie die bevorzugte Zeitzone eines Benutzers abrufen, wird die Zeitzone in dem eingerichteten Format zurückgegeben.When you get a user's preferred time zone, the time zone is returned in the format that it was 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

Um spezifische Einstellungen zu erhalten, werden nur die Einstellungen für automatische Antworten, das Gebietsschema, die Zeitzone oder die Arbeitszeiten angegeben:To get specific settings - only the automatic replies settings, locale, time zone, or working hours:

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

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

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 die OData-Abfrageparameter zur Anpassung der Antwort.This method supports 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:

BeispielExample

Anforderung 1Request 1

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

GET https://graph.microsoft.com/beta/me/mailboxSettings
Antwort 1Response 1

Die Antwort enthält 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"
        }
    }
}
Anforderung 2Request 2

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
Antwort 2Response 2

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"
}
Anforderung 3Request 3

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
Antwort 3Response 3

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
        }
    }
}