Microsoft Graph アクセス許可一覧が知りたい

Office 365のAPI(Microsoft Graph API)を使用して接続するためのアクセス許可一覧です。
DialogPlayの外部システム連携で使用する対象APIごとに必要なスコープを選択し、アクセス許可を設定してください。
対象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ユーザーをログアウトします。
スコープの設定は必要ありません。

Office 365と連携したチャットボットテンプレートを利用する場合

Office 365と連携したチャットボットテンプレートを利用する場合のアクセス許可一覧です。
利用するテンプレートに合わせて、必要なスコープを選択しアクセス許可を設定してください。
テンプレート:「【サンプル】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 サインインとユーザープロファイルの読み取り
Last updated on 2019/04/05.