Office.Ews interface

Pacote:
outlook

Fornece métodos para determinar se os tokens de retorno de chamada do Serviços Web do Exchange (EWS) têm suporte em uma organização.

Comentários

Conjunto de APIs: Caixa de Correio 1.16

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

Modo do Outlook aplicável: Compose ou Ler

Importante: os tokens de identidade do usuário e os tokens de retorno de chamada herdados do Exchange Online não têm mais suporte e estão desativados em todos os locatários do Microsoft 365. Se um suplemento do Outlook exigir acesso de usuário delegado ou identidade de usuário, recomendamos o uso da MSAL (Biblioteca de Autenticação da Microsoft) e da autenticação de aplicativo aninhada (NAA). Os tokens de identidade do usuário do Exchange ainda têm suporte para o Exchange local. Para obter mais informações, consulte Perguntas frequentes sobre autenticação de aplicativo aninhado.

Usada por

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/89-other-mailbox-apis/get-token-status.yaml

Office.context.mailbox.diagnostics.ews.getTokenStatusAsync({ isRest: false }, (result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.log(result.error.message);
    return;
  }
  const status = result.value;
  switch (status) {
    case Office.MailboxEnums.TokenStatus.Enabled:
      console.log("EWS callback tokens are enabled.");
      break;
    case Office.MailboxEnums.TokenStatus.Disabled:
      console.log("EWS callback tokens are disabled.");
      break;
    case Office.MailboxEnums.TokenStatus.Removed:
      console.log("The organization has an Exchange Online environment. Legacy Exchange tokens are no longer supported.");
      break;
  }
});

Métodos

getTokenStatusAsync(options, callback)

Obtém o status dos tokens de retorno de chamada do EWS em uma organização.
getTokenStatusAsync(callback)

Obtém o status dos tokens de retorno de chamada do EWS em uma organização.

Detalhes do método

getTokenStatusAsync(options, callback)

Obtém o status dos tokens de retorno de chamada do EWS em uma organização.

getTokenStatusAsync(options: Office.AsyncContextOptions & { isRest?: boolean }, callback: (asyncResult: Office.AsyncResult<MailboxEnums.TokenStatus>) => void): void;

Parâmetros

options

Office.AsyncContextOptions & { isRest?: boolean }

Um objeto literal que contém uma ou mais das propriedades a seguir. asyncContext : todos os dados que você deseja acessar na função de retorno de chamada. isRest : identifica se o token necessário é para APIs EWS ou REST do Outlook. Por padrão, a isRest propriedade é definida como false.

callback

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

Quando o método é concluído, a função passada no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult. A asyncResult.value propriedade retorna o status do token, que pode serOffice.MailboxEnums.TokenStatus.Enabled , Office.MailboxEnums.TokenStatus.Disabled, ou Office.MailboxEnums.TokenStatus.Removed. Um Office.MailboxEnums.TokenStatus.Removed status indica que a caixa de correio está hospedada em um ambiente do Exchange Online onde os tokens herdados do Exchange estão desativados e não têm mais suporte.

Retornos

void

Comentários

Conjunto de APIs: Caixa de Correio 1.16

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

Modo do Outlook aplicável: Compose ou Ler

Importante:

  • Não há suporte para o getTokenStatusAsync método se você carregar um suplemento em uma caixa de correio do Outlook.com ou do Gmail.

  • Chamar o getTokenStatusAsync método no modo de redação exige que você tenha salvo o item. O saveAsync método requer um nível mínimo de permissão de item de leitura/gravação.

getTokenStatusAsync(callback)

Obtém o status dos tokens de retorno de chamada do EWS em uma organização.

getTokenStatusAsync(callback: (asyncResult: Office.AsyncResult<MailboxEnums.TokenStatus>) => void): void;

Parâmetros

callback

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

Quando o método é concluído, a função passada no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult. A asyncResult.value propriedade retorna o status do token, que pode serOffice.MailboxEnums.TokenStatus.Enabled , Office.MailboxEnums.TokenStatus.Disabled, ou Office.MailboxEnums.TokenStatus.Removed. Um Office.MailboxEnums.TokenStatus.Removed status indica que a caixa de correio está hospedada em um ambiente do Exchange Online onde os tokens herdados do Exchange estão desativados e não têm mais suporte.

Retornos

void

Comentários

Conjunto de APIs: Caixa de Correio 1.16

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

Modo do Outlook aplicável: Compose ou Ler

Importante:

  • Não há suporte para o getTokenStatusAsync método se você carregar um suplemento em uma caixa de correio do Outlook.com ou do Gmail.

  • Chamar o getTokenStatusAsync método no modo de redação exige que você tenha salvo o item. O saveAsync método requer um nível mínimo de permissão de item de leitura/gravação.