外部システム連携の「タイプ：Office365」で使用する対象APIと、各対象APIに必要なMicrosoft Graph アクセス許可一覧です。
Office365連携を利用する際は、対象APIのアクセス許可を〔 Microsoft Azure Portal 〕に登録してください。
必要なアクセス許可が登録されていない場合、外部システム連携を実行した際に権限不足エラーとなります。
Microsoft Azure Portalへアクセス許可を登録する方法については、【チャットボット作成（Ⅳ.Office 365連携編）】を参照してください。
Microsoft Graph アクセス許可一覧
対象API：「ユーザー情報を取得(1件)」
Office 365で管理しているユーザー情報（ユーザー表示名、メールアドレス、役職、事業所など）を取得します。
| 名称 | 説明 |
|---|---|
| offline_access | ユーザーデータへの常時アクセス |
| User.Read | サインインとユーザープロファイルの読み取り |
| User.Read.All | 他ユーザー情報を全て取得 ※権限の承認は管理者のみ可能 |
対象API：「ユーザー情報を検索(複数件)」
Office 365で管理している他ユーザーの情報を検索します。
『表示名 または メールアドレス』に設定した検索ワードで、前方一致検索が行われます。
また、役職や部署などで絞り込みを行うことができます。
| 名称 | 説明 |
|---|---|
| offline_access | ユーザーデータへの常時アクセス |
| People.Read | ユーザーに関係する連絡先リストの読み取り |
対象API：「ユーザーが所属するグループ情報を取得」
Office 365で管理しているグループ情報のリストを取得します。
| 名称 | 説明 |
|---|---|
| Directory.Read.All | ディレクトリ データの読み取り ※権限の承認は管理者のみ可能 |
| offline_access | ユーザーデータへの常時アクセス |
対象API：「グループのメンバーを取得」
グループ内に所属するユーザー情報や、指定したグループに所属するメンバーのリストを取得します。
| 名称 | 説明 |
|---|---|
| Directory.Read.All | ディレクトリ データの読み取り ※権限の承認は管理者のみ可能 |
| offline_access | ユーザーデータへの常時アクセス |
対象API：「イベントを取得(1件)」
予定表で管理している自身、または指定したユーザーの予定を1件取得します。
ユーザーを指定する場合は、ユーザーIDが必要となります。
| 名称 | 説明 |
|---|---|
| Calendars.Read | ユーザーのカレンダーの読み取り |
| Calendars.Read.Shared | ユーザーのカレンダーと共有のカレンダーの読み取り ※他ユーザー情報を取得する場合は、カレンダーの共有設定が必要 |
| MailboxSettings.Read | ユーザーのメールボックス設定の読み取り |
| offline_access | ユーザーデータへの常時アクセス |
対象API：「イベントを取得（複数件）」
予定表で管理している自身、または指定したユーザーの予定を1件以上取得します。
| 名称 | 説明 |
|---|---|
| Calendars.Read | ユーザーのカレンダーの読み取り |
| Calendars.Read.Shared | ユーザーのカレンダーと共有のカレンダーの読み取り ※他ユーザー情報を取得する場合は、カレンダーの共有設定が必要 |
| MailboxSettings.Read | ユーザーのメールボックス設定の読み取り |
| offline_access | ユーザーデータへの常時アクセス |
対象API：「自身のイベントを登録」
自身の予定の登録と、会議室の予約を行ないます。
| 名称 | 説明 |
|---|---|
| Calendars.ReadWrite | ユーザーのカレンダーへのフルアクセス |
| MailboxSettings.Read | ユーザーのメールボックス設定の読み取り |
| offline_access | ユーザーデータへの常時アクセス |
| User.ReadBasic.All | 全ユーザーの基本プロファイルの読み取り |
対象API：「自身のイベントを更新」
自身のイベントの更新を行ないます。
| 名称 | 説明 |
|---|---|
| Calendars.ReadWrite | ユーザーのカレンダーへのフルアクセス |
| offline_access | ユーザーデータへの常時アクセス |
対象API：「自身のイベントを削除」
自身の予定と、予約済会議室の取り消しを行ないます。
| 名称 | 説明 |
|---|---|
| Calendars.ReadWrite | ユーザーのカレンダーへのフルアクセス |
| offline_access | ユーザーデータへの常時アクセス |
対象API：「空き会議日時の検索」
空いている会議室の検索を行ないます。
| 名称 | 説明 |
|---|---|
| Calendars.Read.Shared | ユーザーのカレンダーと共有カレンダーの読み取り ※他ユーザー情報を取得する場合は、カレンダーの共有設定が必要 |
| MailboxSettings.Read | ユーザーのメールボックス設定の読み取り |
| offline_access | ユーザーデータへの常時アクセス |
| User.ReadBasic.All | 全てのユーザーの基本プロファイルの読み取り |
対象API：「Office 365接続を切断」
ログインしているOffice 365ユーザーをログアウトします。
アクセス許可の設定は不要です。
Microsoft Graph アクセス許可マトリクス
| 対象API | Microsoft Graph アクセス許可 （ ○：登録 -：登録不要 ） | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Calendars .Read |
Calendars .Read.Shared |
Calendars .ReadWrite |
Directory .Read.All |
MailboxSettings .Read |
offline _access |
People .Read |
User.Read | User.Read.All ※権限承認は 管理者のみ可能 |
User.ReadBasic .All |
|
| ユーザー情報を取得(1件) | - | - | - | - | - | ○ | - | ○ | ○ | - |
| ユーザー情報を検索(複数件) | - | - | - | - | - | ○ | ○ | - | - | - |
| ユーザーが所属するグループ情報を取得 | - | - | - | ○ | - | ○ | - | - | - | - |
| グループのメンバーを取得 | - | - | - | ○ | - | ○ | - | - | - | - |
| イベントを取得(1件) | ○ | ○ | - | - | ○ | ○ | - | - | - | - |
| イベントを取得(複数件) | ○ | ○ | - | - | ○ | 〇 | - | - | - | - |
| 自身のイベントを登録 | - | - | ○ | - | ○ | ○ | - | - | - | ○ |
| 自身のイベントを更新 | - | - | ○ | - | - | ○ | - | - | - | - |
| 自身のイベントを削除 | - | - | ○ | - | - | ○ | - | - | - | - |
| 空き会議日時の検索 | - | ○ | - | - | ○ | ○ | - | - | - | ○ |
| Office 365接続を切断 | - | - | - | - | - | - | - | - | - | - |
| 対象API | Calendars .Read |
Calendars .Read.Shared |
Calendars .ReadWrite |
Directory .Read.All |
MailboxSettings .Read |
offline _access |
People .Read |
User.Read | User.Read.All ※権限承認は 管理者のみ可能 |
User.ReadBasic .All |
Office 365連携チャットボットテンプレートの利用
Office 365と連携したチャットボットテンプレートを利用する場合のアクセス許可一覧です。
利用するテンプレートに合わせて、対象テンプレートのアクセス許可をMicrosoft Azure Portalに登録してください。
テンプレート：「【サンプル】Office 365会議室予約ボット」
| 名称 | 説明 |
|---|---|
| Calendars.Read | ユーザーのカレンダーの読み取り |
| Calendars.Read.Shared | ユーザーのカレンダーと共有のカレンダーの読み取り ※他ユーザー情報を取得する場合は、カレンダーの共有設定が必要 |
| Calendars.ReadWrite | ユーザーのカレンダーへのフルアクセス |
| MailboxSettings.Read | ユーザーのメールボックス設定の読み取り |
| offline_access | ユーザーデータへの常時アクセス |
| People.Read | ユーザーに関係する連絡先リストの読み取り |
| User.Read | サインインとユーザープロファイルの読み取り |
| User.Read.All | 他ユーザー情報を全て取得 ※権限の承認は管理者のみ可能 |
| User.ReadBasic.All | 全ユーザーの基本プロファイルの読み取り ※他ユーザー情報は「表示名」「姓」「名」「ユーザー識別名」のみ取得可能 |
テンプレート：「【サンプル】Office 365名刺発注受付ボット」
| 名称 | 説明 |
|---|---|
| offline_access | ユーザーデータへの常時アクセス |
| Sites.Read.All | すべてのサイトコレクションに含まれるアイテムの読み取り |
| User.Read | サインインとユーザープロファイルの読み取り |
テンプレート：「【サンプル】Office 365営業活動履歴登録ボット」
| 名称 | 説明 |
|---|---|
| offline_access | ユーザーデータへの常時アクセス |
| Sites.Read.All | すべてのサイトコレクションに含まれるアイテムの読み取り |
| User.Read | サインインとユーザープロファイルの読み取り |
Office 365連携テンプレート Microsoft Graph アクセス許可マトリクス
| サンプル テンプレート名 |
Microsoft Graph アクセス許可 （ ○：登録 -：登録不要 ） | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Calendars .Read |
Calendars .Read.Shared |
Calendars .ReadWrite |
Directory .Read.All |
MailboxSettings .Read |
offline _access |
People .Read |
Sites .Read.All |
User.Read | User.Read.All ※権限承認は 管理者のみ可能 |
User.ReadBasic .All |
|
| Office 365会議室予約ボット | ○ | ○ | ○ | - | ○ | ○ | ○ | - | ○ | ○ | ○ |
| Office 365名刺発注受付ボット | - | - | - | - | - | ○ | - | ○ | ○ | - | - |
| Office 365営業活動履歴登録ボット | - | - | - | - | - | ○ | - | ○ | ○ | - | - |