Atualizar as configurações de caixa de correio do usuárioUpdate user mailbox settings

Habilitar, configurar ou desabilitar uma ou mais das seguintes configurações como parte do mailboxSettingsde um usuário:Enable, configure, or disable one or more of the following settings as part of a user's mailboxSettings:

Ao atualizar o formato de data ou hora preferencial para um usuário, especifique-o, respectivamente, o formato de data abreviada ou de hora curta .When updating the preferred date or time format for a user, specify it in respectively, the short date or short time format.

Ao atualizar o fuso horário preferencial para um usuário, especifique-o no formato de fuso horário do Windows ou da autoridade de números atribuídos à Internet (IANA) (também conhecido como fuso horário do Olson).When updating the preferred time zone for a user, specify it in the Windows or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. Você também pode personalizar ainda mais o fuso horário, conforme mostrado no exemplo 2 abaixo.You can also further customize the time zone as shown in example 2 below.

Dica

Você não pode criar nem excluir nenhuma configuração de caixa de correio.You cannot create or delete any mailbox settings.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) MailboxSettings.ReadWriteMailboxSettings.ReadWrite
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) MailboxSettings.ReadWriteMailboxSettings.ReadWrite
AplicativoApplication MailboxSettings.ReadWriteMailboxSettings.ReadWrite

Solicitação HTTPHTTP request

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

Parâmetros de consulta opcionaisOptional query parameters

Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.This method supports the OData Query Parameters to help customize the response.

Cabeçalhos de solicitaçãoRequest headers

NomeName TipoType DescriçãoDescription
AutorizaçãoAuthorization stringstring {token} de portador. Obrigatório.Bearer {token}. Required.

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça os valores para as propriedades relevantes que devem ser atualizadas. Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações em outros valores de propriedade. Para obter o melhor desempenho, não inclua valores existentes que não foram alterados. Estas são as propriedades graváveis/atualizáveis:In the request body, supply the values for the relevant properties that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed. The following are the writable/updatable properties:

PropriedadeProperty TipoType DescriçãoDescription
automaticRepliesSettingautomaticRepliesSetting automaticRepliesSettingautomaticRepliesSetting Definições de configuração para notificar automaticamente o remetente de um email recebido com uma mensagem do usuário conectado.Configuration settings to automatically notify the sender of an incoming email with a message from the signed-in user. Você pode definir essas notificações para apenas um intervalo de datas futuras.You can set such notifications for only a future date range.
dateFormatdateFormat stringstring O formato de data da caixa de correio do usuário.The date format for the user's mailbox.
idiomalanguage localeInfolocaleInfo Informações sobre a localidade do usuário, incluindo o idioma preferencial e o país/região.The locale information for the user, including the preferred language and country/region.
Formato de TimeFormattimeFormat stringstring O formato de hora da caixa de correio do usuário.The time format for the user's mailbox.
timeZonetimeZone stringstring O fuso horário padrão para a caixa de correio do usuário.The default time zone for the user's mailbox.
workingHoursworkingHours workingHoursworkingHours As horas, os dias de uma semana e o fuso horário em que o usuário trabalha.The hours, days of a week, and time zone that the user works.

RespostaResponse

Se tiver êxito, este método retornará 200 OK um código de resposta e as propriedades atualizadas de um objeto mailboxSettings no corpo da resposta.If successful, this method returns a 200 OK response code and the updated properties of a mailboxSettings object in the response body.

ErrosErrors

Definir horas de trabalho com valores inadequados pode retornar os seguintes erros.Setting working hours with inappropriate values may return the following errors.

CenárioScenario Código de status de HTTPHTTP status code Código de erroError code Mensagem de erroError message
startTime ou endTime inválidoInvalid startTime or endTime 400400 RequestBodyReadRequestBodyRead Não é possível converter o literal '08"para o tipo 'Edm.TimeOfDay' esperado.Cannot convert the literal '08' to the expected type 'Edm.TimeOfDay'.
A hora de início é maior do que a hora de términoStart time is greater than end time 400400 ErrorInvalidTimeSettingsErrorInvalidTimeSettings A Hora de Início deve ocorrer antes da Hora de Término.Start Time should occur before End Time.
Dia inválido em daysOfWeekInvalid day in daysOfWeek 400400 InvalidArgumentsInvalidArguments O valor solicitada "RandomDay" não foi encontrado.Requested value 'RandomDay' was not found.
timeZone inválidoInvalid timeZone 400400 InvalidTimeZoneInvalidTimeZone As configurações de Fuso Horário fornecidas são inválidas.Time Zone settings provided are invalid.

ExemplosExamples

Exemplo 1Example 1

SolicitaçãoRequest

O primeiro exemplo habilita as respostas automáticas de um intervalo de datas, definindo as seguintes propriedades da propriedade automaticRepliesSetting: status, scheduledStartDateTime e scheduledEndDateTime.The first example enables automatic replies for a date range, by setting the following properties of the automaticRepliesSetting property: status, scheduledStartDateTime and 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"
        }
    }
}

RespostaResponse

A resposta inclui apenas as configurações atualizadas de respostas automáticas.The response includes the updated settings for automatic replies. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão.Note: The response object shown here may be truncated for brevity. Todas as propriedades serão retornadas de uma chamada real.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/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"
    }
}

Exemplo 2Example 2

SolicitaçãoRequest

O segundo exemplo personaliza o fuso horário das horas de trabalho do usuário conectado definindo a propriedade timeZone para um fuso horário personalizado.The second example customizes the time zone for the working hours of the signed-in user, by setting the timeZone property to a custom time zone.

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

RespostaResponse

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.Here is an example of the response. 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/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
            }
        }
    }
}