Feedback Bearbeiten

Postfacheinstellungen des Benutzers aktualisieren

  • Artikel
  • 7 Minuten Lesedauer

Namespace: microsoft.graph

Aktivieren, konfigurieren oder deaktivieren Sie eine oder mehrere der folgenden Einstellungen als Teil der mailboxSettingseines Benutzers:

Geben Sie beim Aktualisieren des bevorzugten Datums- oder Uhrzeitformats für einen Benutzer das kurze Datums- oder Kurzzeitformat an.

Wenn Sie die bevorzugte Zeitzone für einen Benutzer aktualisieren, geben Sie sie im Format Windows oder IANA (Internet Assigned Numbers Authority) an (auch als Olson-Zeitzone bezeichnet). Sie können die Zeitzone auch weiter anpassen, wie in Beispiel 2 unten dargestellt.

Tipp

Sie können keine Postfacheinstellungen erstellen oder löschen.

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.ReadWrite
Delegiert (persönliches Microsoft-Konto) MailboxSettings.ReadWrite
Anwendung MailboxSettings.ReadWrite

HTTP-Anforderung

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

Optionale Abfrageparameter

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

Anforderungsheader

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

Anforderungstext

Geben Sie im Anforderungstext die Werte für die relevanten Eigenschaften an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben. Im Folgenden werden die beschreibbaren/aktualisierbaren Eigenschaften aufgelistet:

Eigenschaft Typ Beschreibung
automaticRepliesSetting automaticRepliesSetting Konfigurationseinstellungen zum automatischen Benachrichtigen des Absenders bei eingehenden E-Mails mit einer Nachricht vom angemeldeten Benutzer. Sie können solche Benachrichtigungen nur für einen zukünftigen Datumsbereich festlegen.
Dateformat Zeichenfolge Das Datumsformat für das Postfach des Benutzers.
delegateMeetingMessageDeliveryOptions delegateMeetingMessageDeliveryOptions Wenn der Benutzer über einen Kalenderdelegat verfügt, gibt dies an, ob die Stellvertretung, der Postfachbesitzer oder beide Besprechungsnachrichten und Besprechungsantworten empfangen. Mögliche Werte sind: sendToDelegateAndInformationToPrincipal, sendToDelegateAndPrincipal und sendToDelegateOnly.
language localeInfo Die Gebietsschemainformationen des Benutzers, einschließlich der bevorzugten Sprache und Land/Region.
Timeformat Zeichenfolge Das Zeitformat für das Postfach des Benutzers.
timeZone string Die Standardzeitzone für das Postfach des Benutzers.
workingHours workingHours Die Stunden, Wochentage und die Zeitzone, an denen bzw. in der der Benutzer arbeitet.

Antwort

Bei erfolgreicher Ausführung gibt die Methode 200 OK den Antwortcode und die aktualisierten Eigenschaften eines mailboxSettings-Objekts im Antworttext zurück.

Fehler

Durch Festlegen von Geschäftszeiten mit falschen Werten können möglicherweise die folgenden Fehler zurückgegeben werden.

Szenario HTTP-Statuscode Fehlercode Fehlermeldung
Ungültige startTime oder endTime 400 RequestBodyRead Das Literal „08“ kann nicht in den erwarteten Typ „Edm.TimeOfDay“ konvertiert werden.
Die Startzeit größer als die Endzeit 400 ErrorInvalidTimeSettings Die Startzeit muss vor der Endzeit liegen.
Ungültiger Tag in daysOfWeek 400 InvalidArguments Der angeforderte Wert „RandomDay“ wurde nicht gefunden.
Ungültige timeZone 400 InvalidTimeZone Die angegebenen Zeitzoneneinstellungen sind ungültig.

Beispiele

Beispiel 1

Anforderung

Im folgenden Beispiel werden automatische Antworten für einen bestimmten Datumsbereich durch Festlegen der folgenden Eigenschaften der automaticRepliesSetting-Eigenschaft aktiviert: status, scheduledStartDateTime und scheduledEndDateTime.

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

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

Antwort

Die Antwort enthält die aktualisierten 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": "scheduled",
        "externalAudience": "all",
        "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"
    }
}

Beispiel 2

Anforderung

Das zweite Beispiel passt die Zeitzone für die Geschäftszeiten des angemeldeten Benutzers an, indem die timeZone-Eigenschaft auf eine benutzerdefinierte Zeitzone festgelegt wird.

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

{
  "workingHours": {
      "endTime" : "18:30:00.0000000", 
      "daysOfWeek": [ 
          "Monday", 
          "Tuesday", 
          "Wednesday", 
          "Thursday", 
          "Friday", 
          "Saturday" 
      ], 
      "timeZone" : { 
         "@odata.type": "#microsoft.graph.customTimeZone", 
         "bias":-300, 
         "name": "Customized Time Zone",
         "standardOffset":{   
           "time":"02:00:00.0000000", 
           "dayOccurrence":2, 
           "dayOfWeek":"Sunday", 
           "month":10, 
           "year":0 
         }, 
         "daylightOffset":{   
           "daylightBias":100, 
           "time":"02:00:00.0000000", 
           "dayOccurrence":4, 
           "dayOfWeek":"Sunday", 
           "month":5, 
           "year":0 
         } 
      } 
  }
}

Antwort

Hier ist ein Beispiel für die Antwort. Hinweis: Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

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