Office.MailboxEnums.TokenStatus enum

organization 内の Exchange Web サービス (EWS) コールバック トークンまたは REST API トークンの状態を指定します。

注釈

API セット: メールボックス 1.16

適用可能な Outlook モード: Composeまたは読み取り

重要: 従来の Exchange Online ユーザー ID トークンとコールバック トークンはサポートされなくなり、すべての Microsoft 365 テナントでオフになっています。 Outlook アドインで代理ユーザー アクセスまたはユーザー ID が必要な場合は、MSAL (Microsoft 認証ライブラリ) と入れ子になったアプリ認証 (NAA) を使うことをお勧めします。 Exchange ユーザー ID トークンは、Exchange オンプレミスで引き続きサポートされます。 詳細については、「 入れ子になったアプリ認証に関する FAQ」を参照してください。

使用元

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

フィールド

Disabled = 0

EWS コールバック トークンまたは REST API トークンは、organization ではオフになっています。

Enabled = 1

EWS コールバック トークンまたは REST API トークンは、organization でサポートされています。

Removed = 2

メールボックスは、EWS トークンがオフになり、サポートされなくなった Exchange Online 環境でホストされています。