Office.Ews interface

Paquete:
outlook

Proporciona métodos para determinar si los tokens de devolución de llamada de servicios Web Exchange (EWS) son compatibles con una organización.

Comentarios

Conjunto de API: Buzón 1.16

Nivel mínimo de permisos: Leer elemento

Modo de Outlook aplicable: Componer o leer

Importante: Los tokens de identidad de usuario y los tokens de devolución de llamada de Exchange Online heredados ya no se admiten y están desactivados en todos los inquilinos de Microsoft 365. Si un complemento de Outlook requiere acceso de usuario delegado o identidad de usuario, se recomienda usar MSAL (Biblioteca de autenticación de Microsoft) y la autenticación de aplicaciones anidada (NAA). Los tokens de identidad de usuario de Exchange aún se admiten para Exchange local. Para obtener más información, consulte Preguntas frecuentes sobre la autenticación de aplicaciones anidadas.

Usada por

Ejemplos

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

Obtiene el estado de los tokens de devolución de llamada de EWS en una organización.
getTokenStatusAsync(callback)

Obtiene el estado de los tokens de devolución de llamada de EWS en una organización.

Detalles del método

getTokenStatusAsync(options, callback)

Obtiene el estado de los tokens de devolución de llamada de EWS en una organización.

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

Parámetros

options

Office.AsyncContextOptions & { isRest?: boolean }

Un objeto literal que contiene una o más de las siguientes propiedades. asyncContext : cualquier dato al que quieras acceder en la función de devolución de llamada. isRest : identifica si el token necesario es para las API de EWS o REST de Outlook. De forma predeterminada, la isRest propiedad se establece en false.

callback

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

Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro de tipo Office.AsyncResult. La asyncResult.value propiedad devuelve el estado del token, que puede serOffice.MailboxEnums.TokenStatus.Enabled , Office.MailboxEnums.TokenStatus.Disabledo Office.MailboxEnums.TokenStatus.Removed. Un Office.MailboxEnums.TokenStatus.Removed estado indica que el buzón está alojado en un entorno de Exchange Online en el que los tokens de Exchange heredados están desactivados y ya no son compatibles.

Devoluciones

void

Comentarios

Conjunto de API: Buzón 1.16

Nivel mínimo de permisos: Leer elemento

Modo de Outlook aplicable: Componer o leer

Importante:

  • El getTokenStatusAsync método no es compatible si carga un complemento en un buzón de Outlook.com o Gmail.

  • La llamada al getTokenStatusAsync método en modo de redacción requiere que haya guardado el elemento. El saveAsync método requiere un nivel mínimo de permisos de elemento de lectura y escritura.

getTokenStatusAsync(callback)

Obtiene el estado de los tokens de devolución de llamada de EWS en una organización.

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

Parámetros

callback

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

Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro de tipo Office.AsyncResult. La asyncResult.value propiedad devuelve el estado del token, que puede serOffice.MailboxEnums.TokenStatus.Enabled , Office.MailboxEnums.TokenStatus.Disabledo Office.MailboxEnums.TokenStatus.Removed. Un Office.MailboxEnums.TokenStatus.Removed estado indica que el buzón está alojado en un entorno de Exchange Online en el que los tokens de Exchange heredados están desactivados y ya no son compatibles.

Devoluciones

void

Comentarios

Conjunto de API: Buzón 1.16

Nivel mínimo de permisos: Leer elemento

Modo de Outlook aplicable: Componer o leer

Importante:

  • El getTokenStatusAsync método no es compatible si carga un complemento en un buzón de Outlook.com o Gmail.

  • La llamada al getTokenStatusAsync método en modo de redacción requiere que haya guardado el elemento. El saveAsync método requiere un nivel mínimo de permisos de elemento de lectura y escritura.