Office.Ews interface

Пакет:

outlook

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Предоставляет методы для определения поддержки маркеров обратного вызова веб-служб Exchange (EWS) в организации.

Комментарии

[ Набор API: предварительная версия почтового ящика ]

Минимальный уровень разрешений: чтение элемента

Применимый режим Outlook: Compose или чтение

Важно! Устаревшие Exchange Online маркеры удостоверений пользователей и маркеры обратного вызова больше не поддерживаются и отключены во всех клиентах Microsoft 365. Если надстройке Outlook требуется делегированный доступ или удостоверение пользователя, рекомендуется использовать MSAL (библиотека проверки подлинности Майкрософт) и вложенную проверку подлинности приложения (NAA). Маркеры удостоверений пользователей Exchange по-прежнему поддерживаются для локальной среды Exchange. Дополнительные сведения см. в разделе Часто задаваемые вопросы о проверке подлинности вложенных приложений.

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/99-preview-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;
  }
});

Методы

getTokenStatusAsync(options, callback)	Возвращает состояние маркеров обратного вызова EWS в организации.
getTokenStatusAsync(callback)	Возвращает состояние маркеров обратного вызова EWS в организации.

Сведения о методе

getTokenStatusAsync(options, callback)

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Возвращает состояние маркеров обратного вызова EWS в организации.

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

Параметры

options

Office.AsyncContextOptions & { isRest?: boolean }

Объектный литерал, содержащий одно или несколько из указанных ниже свойств. asyncContext : любые данные, к которым вы хотите получить доступ в функции обратного вызова. isRest : определяет, требуется ли маркер для EWS или REST API Outlook. По умолчанию isRest свойство имеет значение false.

callback

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

После завершения метода функция, переданная в callback параметре, вызывается с одним параметром типа Office.AsyncResult. Свойство asyncResult.value возвращает состояние маркера, которое может иметь значение Office.MailboxEnums.TokenStatus.Enabled, Office.MailboxEnums.TokenStatus.Disabledили Office.MailboxEnums.TokenStatus.Removed. Состояние Office.MailboxEnums.TokenStatus.Removed указывает, что почтовый ящик размещен в среде Exchange Online, где устаревшие маркеры Exchange отключены и больше не поддерживаются.

Возвращаемое значение

void

Комментарии

[ Набор API: предварительная версия почтового ящика ]

Минимальный уровень разрешений: чтение элемента

Применимый режим Outlook: Compose или чтение

Важно!

• Метод getTokenStatusAsync доступен для предварительной версии в Outlook в Интернете и в Windows (новая и классическая версия (версия 2510, сборка 19328.20000 и более поздние версии)).

• Этот getTokenStatusAsync метод не поддерживается, если вы загружаете надстройку в почтовый ящик Outlook.com или Gmail.

• getTokenStatusAsync Вызов метода в режиме создания требует сохранения элемента. Для saveAsync метода требуется минимальный уровень разрешений для чтения и записи элемента.

getTokenStatusAsync(callback)

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Возвращает состояние маркеров обратного вызова EWS в организации.

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

Параметры

callback

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

После завершения метода функция, переданная в callback параметре, вызывается с одним параметром типа Office.AsyncResult. Свойство asyncResult.value возвращает состояние маркера, которое может иметь значение Office.MailboxEnums.TokenStatus.Enabled, Office.MailboxEnums.TokenStatus.Disabledили Office.MailboxEnums.TokenStatus.Removed. Состояние Office.MailboxEnums.TokenStatus.Removed указывает, что почтовый ящик размещен в среде Exchange Online, где устаревшие маркеры Exchange отключены и больше не поддерживаются.

Возвращаемое значение

void

Комментарии

[ Набор API: предварительная версия почтового ящика ]

Минимальный уровень разрешений: чтение элемента

Применимый режим Outlook: Compose или чтение

Важно!

• Метод getTokenStatusAsync доступен для предварительной версии в Outlook в Интернете и в Windows (новая и классическая версия (версия 2510, сборка 19328.20000 и более поздние версии)).

• Этот getTokenStatusAsync метод не поддерживается, если вы загружаете надстройку в почтовый ящик Outlook.com или Gmail.

• getTokenStatusAsync Вызов метода в режиме создания требует сохранения элемента. Для saveAsync метода требуется минимальный уровень разрешений для чтения и записи элемента.