Microsoft Graph の試し方

2019/7/16 Microsoft Graph

Microsoft Graph を試すには Graph Explorer を使用するのが簡単です。ですが自分で用意した Client ID を使用したり、アプリケーションの権限を使用したりすることはできません。そのため、ここでは Office365APIEditor を使用して Microsoft Graph の動作を検証する方法を紹介します。紹介するのはメールの取得方法のみですが、同じ要領で他の権限を使用して様々な情報にアクセスができます。Office365APIEditor の通信を Fiddler で取得すれば、どのような通信が行われているのか確認することができます。 実際に Microsoft Graph を使用するアプリケーションを開発する場合は、これらの通信をライブラリを使用しながら (もちろん使用しないことも可能) 実装することになります。

Microsoft Graph reports API の試し方については Microsoft Graph reports API の試し方を参照してください。

[委任されたアクセス許可] を Office365APIEditor で試す (ビルトイン編)

アクセス トークンの種類Delegated token
ツールOffice365APIEditor
認証エンドポイントv2.0
APIMicrosoft Graph
  1. Office365APIEditor をインストールして起動します。
  2. [Tools] – [New Editor] をクリックします。
  3. [File] – [New Access Token] をクリックします。
  4. [I have not registered the application.] を選択して [Next] をクリックします。
  5. [Office365APIEditor built-in application] を選択して [Next] をクリックします。
  6. [Scope editor] をクリックします。
  7. [Select default values] をクリックして [OK] をクリックします。
  8. [Next] をクリックします。
  9. Office 365 のユーザーでサインインします。
  10. 上部ペインの [Request] に「https://graph.microsoft.com/v1.0/me/messages」と入力して [Run] をクリックします。
  11. 下部ペインの [Body] に操作をしているユーザーのメールが表示されます。

[委任されたアクセス許可] を Office365APIEditor で試す (カスタム アプリ編)

アクセス トークンの種類Delegated token
ツールOffice365APIEditor
認証エンドポイントv1.0
APIMicrosoft Graph
  1. Azure Portal にサインインします。
  2. [Azure Active Directory] – [アプリの登録] – [新規登録] をクリックします。
  3. [名前] に任意のアプリの名前を入力します。(例 : App01)
  4. [サポートされているアカウントの種類] から [この組織のディレクトリ内のアカウントのみ] を選択します。
  5. [リダイレクト URI] で [パブリック クライアント (モバイルとデスクトップ)] を選択し、任意の URI を入力します。(例 : https://localhost/App01)
  6. [登録] をクリックします。
  7. 表示された [アプリケーション (クライアント) ID] の値を控えておきます。
  8. [管理] – [API のアクセス許可] をクリックします。
  9. [アクセス許可の追加] をクリックします。
  10. [Microsoft Graph] をクリックします。
  11. [委任されたアクセス許可] をクリックします。
  12. [Mail] – [Mail.Read] のチェックをオンにします。
  13. [アクセス許可の追加] をクリックします。
  14. Office365APIEditor をインストールして起動します。
  15. [Tools] – [New Editor] をクリックします。
  16. [File] – [New Access Token] をクリックします。
  17. [v1.0 Endpoint] を選択して [Next] をクリックします。
  18. [Public client/native (mobile & desktop) app] を選択して [Next] をクリックします。
  19. [Tenant Name] にアプリを登録したテナントの onmicrosoft.com のドメイン名を入力します。(例 : contoso.onmicrosoft.com)
  20. [Application ID] に手順 7 で控えた値を入力します。
  21. [Redirect URI] に手順 5 で入力した URI を入力します。
  22. [Resource] から [Microsoft Graph] を選択します。
  23. [Next] をクリックします。
  24. Office 365 のユーザーでサインインします。
  25. 上部ペインの [Request] に「https://graph.microsoft.com/v1.0/me/messages」と入力して [Run] をクリックします。
  26. 下部ペインの [Body] に操作をしているユーザーのメールが表示されます。

[アプリケーションの許可] を Office365APIEditor で試す

アクセス トークンの種類App-Only token
ツールOffice365APIEditor
認証エンドポイントv1.0
APIMicrosoft Graph
  1. Azure Portal にサインインします。
  2. [Azure Active Directory] – [アプリの登録] – [新規登録] をクリックします。
  3. [名前] に任意のアプリの名前を入力します。(例 : App02)
  4. [サポートされているアカウントの種類] から [この組織のディレクトリ内のアカウントのみ] を選択します。
  5. [リダイレクト URI] で [Web] を選択し、任意の URI を入力します。(例 : https://localhost/App02)
  6. [登録] をクリックします。
  7. 表示された [アプリケーション (クライアント) ID] の値を控えておきます。
  8. [管理] – [証明書とシークレット] – [クライアント シークレット] をクリックします。
  9. [新しいクライアント シークレット] をクリックします。
  10. [説明] に任意の説明を入力します。(例 : Key1)
  11. [有効期限] から任意の有効期限を選択します。(例 : 推奨: 180 日 (6 か月))
  12. [追加] をクリックします。
  13. 表示されたクライアント シークレットの値を控えておきます。
  14. [管理] – [API のアクセス許可] をクリックします。
  15. [アクセス許可の追加] をクリックします。
  16. [Microsoft Graph] をクリックします。
  17. [アプリケーションの許可] をクリックします。
  18. [Mail] – [Mail.Read] のチェックをオンにします。
  19. [アクセス許可の追加] をクリックします。
  20. [<テナント名> に管理者の同意を与えます] をクリックします。
  21. [はい] をクリックします。
  22. Office365APIEditor をインストールして起動します。
  23. [Tools] – [New Editor] をクリックします。
  24. [File] – [New Access Token] をクリックします。
  25. [v1.0 Endpoint] を選択して [Next] をクリックします。
  26. [Web app / API (Use App Only Token by client secret] を選択して [Next] をクリックします。
  27. [Tenant Name] にアプリを登録したテナントの onmicrosoft.com のドメイン名を入力します。(例 : contoso.onmicrosoft.com)
  28. [Application ID] に手順 7 で控えた値を入力します。
  29. [Resource] から [Microsoft Graph] を選択します。
  30. [Client secret] に手順 13 で控えた値を入力します。
  31. [Next] をクリックします。
  32. 上部ペインの [Request] に「https://graph.microsoft.com/v1.0/users/<任意のユーザーの UPN>/messages」と入力して [Run] をクリックします。(例 : https://graph.microsoft.com/v1.0/users/user01@contoso.onmicrosoft.com/messages)
  33. 下部ペインの [Body] に指定したユーザーのメールが表示されます。