Share via


Office.Sensitivity interface

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Fornece métodos para obter e definir o nível de confidencialidade de um compromisso. Para saber mais sobre níveis de confidencialidade, consulte Marcar seu email como Normal, Pessoal, Privado ou Confidencial.

Comentários

[ Conjunto de API: visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura

Modo outlook aplicável: compose

Métodos

getAsync(options, callback)

Obtém o nível de confidencialidade de um compromisso.

getAsync(callback)

Obtém o nível de confidencialidade de um compromisso.

setAsync(sensitivity, options, callback)

Define o nível de confidencialidade de um compromisso.

setAsync(sensitivity, callback)

Define o nível de confidencialidade de um compromisso.

Detalhes do método

getAsync(options, callback)

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Obtém o nível de confidencialidade de um compromisso.

getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<MailboxEnums.AppointmentSensitivityType>) => void): void;

Parâmetros

options
Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades:- asyncContext: Os desenvolvedores podem fornecer qualquer objeto que desejam acessar na função de retorno de chamada.

callback

(asyncResult: Office.AsyncResult<Office.MailboxEnums.AppointmentSensitivityType>) => void

Quando o método é concluído, a função passada no callback parâmetro é chamada com um único parâmetro, , asyncResultque é um Office.AsyncResult objeto. O nível de confidencialidade do compromisso é retornado na asyncResult.value propriedade.

Retornos

void

Comentários

[ Conjunto de API: visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura

Modo outlook aplicável: compose

Importante: Outlook na Web, Outlook no Mac e o novo Outlook no Windows (versão prévia) só dão suporte a níveis de confidencialidade normais e privados. Se você chamar getAsync em um compromisso que tenha um nível de confidencialidade confidencial ou pessoal desses clientes, o nível de confidencialidade normal será retornado na asyncResult.value propriedade.

getAsync(callback)

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Obtém o nível de confidencialidade de um compromisso.

getAsync(callback: (asyncResult: Office.AsyncResult<MailboxEnums.AppointmentSensitivityType>) => void): void;

Parâmetros

callback

(asyncResult: Office.AsyncResult<Office.MailboxEnums.AppointmentSensitivityType>) => void

Quando o método é concluído, a função passada no callback parâmetro é chamada com um único parâmetro, , asyncResultque é um Office.AsyncResult objeto. O nível de confidencialidade do compromisso é retornado na asyncResult.value propriedade.

Retornos

void

Comentários

[ Conjunto de API: visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura

Modo outlook aplicável: compose

Importante: Outlook na Web, Outlook no Mac e o novo Outlook no Windows (versão prévia) só dão suporte a níveis de confidencialidade normais e privados. Se você chamar getAsync em um compromisso que tenha um nível de confidencialidade confidencial ou pessoal desses clientes, o nível de confidencialidade normal será retornado na asyncResult.value propriedade.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/99-preview-apis/calendar-properties-apis.yaml

Office.context.mailbox.item.sensitivity.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Sensitivity: " + asyncResult.value);
  } else {
    console.log("Failed to get sensitivity: " + JSON.stringify(asyncResult.error));
  }
});

setAsync(sensitivity, options, callback)

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Define o nível de confidencialidade de um compromisso.

setAsync(sensitivity: MailboxEnums.AppointmentSensitivityType | string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

sensitivity

Office.MailboxEnums.AppointmentSensitivityType | string

O nível de confidencialidade como enumeração ou cadeia de caracteres.

options
Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades:- asyncContext: Os desenvolvedores podem fornecer qualquer objeto que desejam acessar na função de retorno de chamada.

callback

(asyncResult: Office.AsyncResult<void>) => void

Opcional. Quando o método é concluído, a função passada no callback parâmetro é chamada com um único parâmetro, , asyncResultque é um Office.AsyncResult objeto.

Retornos

void

Comentários

[ Conjunto de API: visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/gravação

Modo outlook aplicável: compose

Importante: Outlook na Web, Outlook no Mac e o novo Outlook no Windows (versão prévia) só dão suporte a níveis de confidencialidade normais e privados.

Erros:

  • Unsupported API parameter: não há suporte para definir o nível de confidencialidade de um compromisso.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/99-preview-apis/calendar-properties-apis.yaml

Office.context.mailbox.item.sensitivity.setAsync(
  Office.MailboxEnums.AppointmentSensitivityType.Confidential,
  function callback(asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Failed) {
      console.log("Failed to set appointment sensitivity: " + JSON.stringify(asyncResult.error));
    } else {
      console.log("Successfully set appointment sensitivity.");
    }
  }
);

setAsync(sensitivity, callback)

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Define o nível de confidencialidade de um compromisso.

setAsync(sensitivity: MailboxEnums.AppointmentSensitivityType | string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

sensitivity

Office.MailboxEnums.AppointmentSensitivityType | string

O nível de confidencialidade como enumeração ou cadeia de caracteres.

callback

(asyncResult: Office.AsyncResult<void>) => void

Opcional. Quando o método é concluído, a função passada no callback parâmetro é chamada com um único parâmetro, , asyncResultque é um Office.AsyncResult objeto.

Retornos

void

Comentários

[ Conjunto de API: visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/gravação

Modo outlook aplicável: compose

Importante: Outlook na Web, Outlook no Mac e o novo Outlook no Windows (versão prévia) só dão suporte a níveis de confidencialidade normais e privados.

Erros:

  • Unsupported API parameter: não há suporte para definir o nível de confidencialidade de um compromisso.