Feedback Bearbeiten

Postfacheinstellungen des Benutzers abrufen

  • Artikel
  • 5 Minuten Lesedauer

Namespace: microsoft.graph

Rufen Sie die mailboxSettings des Benutzers ab. Sie können alle Postfacheinstellungen anzeigen oder bestimmte Einstellungen abrufen.

Benutzer können die folgenden Einstellungen für Ihre Postfächer über einen Outlook-Client festlegen:

Benutzer können ihre bevorzugten Datums- und Uhrzeitformate mit Outlook im Web festlegen. Benutzer können eines der unterstützten Kurzes Datum- oder Kurze Uhrzeit-Formate aussuchen. Dieser GET-Vorgang gibt das vom Benutzer ausgesuchte Format zurück.

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. Der Administrator kann Zeitzonen im Windows-Zeitzonenformat oder im IANA-Format (Internet Assigned Numbers Authority) (auch als Olson-Zeitzone bezeichnet) einrichten. Das Windows-Format ist die Standardeinstellung.

Dieser GET-Vorgang gibt die bevorzugte Zeitzone des Benutzers in dem vom Administrator eingerichteten Format zurück. 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. Anschließend können Sie die Zeitzone in diesem Format abrufen. Alternativ können Sie die Formatkonvertierung separat in Ihrer App verwalten.

Berechtigungen

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.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) MailboxSettings.Read, MailboxSettings.ReadWrite
Delegiert (persönliches Microsoft-Konto) MailboxSettings.Read, MailboxSettings.ReadWrite
Anwendung MailboxSettings.Read, MailboxSettings.ReadWrite

HTTP-Anforderung

So rufen Sie alle Postfacheinstellungen für einen Benutzer ab:

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:

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 Abfrageparameter

Diese Methode unterstützt einige der OData-Abfrageparameter zur Anpassung der Antwort.

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eines der folgenden angeforderten Objekte im Antworttext zurückgegeben:

Beispiele

Beispiel 1

Anforderung

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.

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

Antwort

Die Antwort umfasst alle Postfacheinstellungen des angemeldeten Benutzers. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt sein.

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"
        }
    },
    "dateFormat": "MM/dd/yyyy",
    "timeFormat": "hh:mm tt",
    "delegateMeetingMessageDeliveryOptions": "sendToDelegateOnly"
}

Beispiel 2

Anforderung

Im zweiten Beispiel werden die Einstellungen für automatische Antworten für das Postfach des angemeldeten Benutzers abgerufen.

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

Antwort

Die Antwort enthält nur die Einstellungen für automatische Antworten. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt sein.

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

Beispiel 3

Anforderung

Im dritten Beispiel werden die Einstellungen für die Geschäftszeiten für das Postfach des angemeldeten Benutzers abgerufen.

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

Antwort

Die Antwort enthält nur die Einstellungen für Geschäftszeiten. Beachten Sie, dass sich die Geschäftszeiten des Benutzers in einer benutzerdefinierten Zeitzone befinden. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt sein.

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