Postfacheinstellungen des Benutzers aktualisieren

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Verwenden Sie die Versionsauswahl, um festzustellen, ob eine API in Version 1.0 verfügbar ist.

Aktivieren, Konfigurieren oder Deaktivieren einer oder mehrere der folgenden Einstellungen als Teil der mailboxSettings eines Benutzers:

Wenn Sie das bevorzugte Datums- oder Uhrzeitformat für einen Benutzer aktualisieren, geben Sie es jeweils im kurzen Datums- oder Kurzzeitformat an.

Wenn Sie die bevorzugte Zeitzone für einen Benutzer aktualisieren, geben Sie sie im Zeitzonenformat 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 gezeigt.

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 string Das Datumsformat für das Postfach des Benutzers.
delegateMeetingMessageDeliveryOptions delegateMeetingMessageDeliveryOptions Wenn der Benutzer über einen Kalenderstellvertretung verfügt, gibt dies an, ob der 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 string 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

Wenn die Methode erfolgreich ist, werden der Antwortcode und die aktualisierten Eigenschaften eines 200 OK mailboxSettings-Objekts im Antworttext zurückgegeben.

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/beta/me/mailboxSettings
Content-Type: application/json

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

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-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/beta/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

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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