Postfacheinstellungen des Benutzers aktualisieren

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Aktivieren, konfigurieren oder deaktivieren Sie eine 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 Format für kurzes Datum oder kurze Zeit an.

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

Tipp

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

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ✅

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) MailboxSettings.ReadWrite Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) MailboxSettings.ReadWrite Nicht verfügbar.
App MailboxSettings.ReadWrite Nicht verfügbar.

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

Bei erfolgreicher Ausführung gibt die Methode den 200 OK 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/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 sein.

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

Das folgende Beispiel zeigt die Antwort. 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/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
            }
        }
    }
}