Office.UserProfile interface

メールボックスに関連付けられているユーザーに関する情報。 これには、アカウントの種類、表示名、メール アドレス、タイム ゾーンが含まれます。

注釈

最小アクセス許可レベル: 項目の読み取り

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

使用元

プロパティ

accountType

メールボックスに関連付けられているユーザーのアカウントの種類を取得します。

displayName

ユーザーの表示名を取得します。

emailAddress

ユーザーの SMTP 電子メール アドレスを取得します。

timeZone

ユーザーのタイム ゾーンを Windows 形式で取得します。

通常、システム タイム ゾーンが返されます。 ただし、Outlook on the web と新しい Outlook on Windows) では、予定表の環境設定の既定のタイム ゾーンが代わりに返されます。

プロパティの詳細

accountType

メールボックスに関連付けられているユーザーのアカウントの種類を取得します。

accountType: string;

プロパティ値

string

注釈

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

最小アクセス許可レベル: 項目の読み取り

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

次の表に、使用可能なアカウントの種類を示します。

説明
Enterprise メールボックスは、オンプレミスの Exchange サーバーにあります。
Gmail メールボックスは、Gmail アカウントに関連付けられます。
Office365 メールボックスは、Microsoft 365 の職場または学校アカウントに関連付けられています。
outlookCom メールボックスは、個人の Outlook.com アカウントに関連付けられます。

重要:

  • ボリューム ライセンスの永続的なOutlook 2016は、accountType プロパティをサポートしていません。 これを回避するには、Exchange Web サービス (EWS) を使用して、Exchange オンプレミス サーバーで ResolveNames 操作を呼び出します。

  • ハイブリッド Exchange 環境では、返されるアカウントの種類の値は、メールボックスがホストされている場所によって異なります。 メールボックスがオンプレミス サーバー上にある場合、アカウントの種類の値は Enterprise です。 ただし、Exchange Online でホストされている場合、アカウントの種類の値は office365 になります。

console.log(Office.context.mailbox.userProfile.accountType);

displayName

ユーザーの表示名を取得します。

displayName: string;

プロパティ値

string

注釈

最小アクセス許可レベル: 項目の読み取り

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

// Example: Allie Bellew
console.log(Office.context.mailbox.userProfile.displayName);

emailAddress

ユーザーの SMTP 電子メール アドレスを取得します。

emailAddress: string;

プロパティ値

string

注釈

最小アクセス許可レベル: 項目の読み取り

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

// Example: allieb@contoso.com
console.log(Office.context.mailbox.userProfile.emailAddress);

timeZone

ユーザーのタイム ゾーンを Windows 形式で取得します。

通常、システム タイム ゾーンが返されます。 ただし、Outlook on the web と新しい Outlook on Windows) では、予定表の環境設定の既定のタイム ゾーンが代わりに返されます。

timeZone: string;

プロパティ値

string

注釈

最小アクセス許可レベル: 項目の読み取り

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

// Example: Pacific Standard Time
console.log(Office.context.mailbox.userProfile.timeZone);