Outlook REST API の試し方

2019/7/16 Exchange Online, Outlook REST API

Outlook REST API は 2022/11/30 で廃止されることがアナウンスされています。既に Azure AD への Outlook REST API を使用する新しいアプリの登録もできなくなっています。これからアプリケーションを開発する場合は、Microsoft Graph を使用してください。

Outlook REST API を試すには Outlook Sandbox を使用するのが簡単です。ですが自分で用意した Client ID を使用したり、アプリケーションの権限を使用したりすることはできません。また Outlook Sandbox も 2020 年いっぱいで廃止されます。そのため、ここでは Office365APIEditor を使用して Outlook REST API の動作を検証する方法を紹介します。紹介するのはメールの取得方法のみですが、同じ要領で他の権限を使用して様々な情報にアクセスができます。Office365APIEditor の通信を Fiddler で取得すれば、どのような通信が行われているのか確認することができます。 実際に Outlook REST API を使用するアプリケーションを開発する場合は、これらの通信を何らかの開発言語で実装することになります。以前はアプリケーションの許可を使用する方法も掲載していましたが、Outlook REST API の廃止のアナウンスに伴って新しいアプリでは試すことができなくなったので、掲載を取りやめています。

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

アクセス トークンの種類Delegated Token
ツールOffice365APIEditor
認証エンドポイントv2.0
APIOutlook REST API
  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. [Deselect all] をクリックします。
  8. [ https://outlook.office.com/mail.read ] のチェックをオンにします。
  9. [OK] をクリックします。
  10. [Next] をクリックします。
  11. Office 365 のユーザーでサインインします。
  12. 上部ペインの [Request] に「https://outlook.office.com/api/v2.0/me/messages」と入力して [Run] をクリックします。
  13. 下部ペインの [Body] に操作をしているユーザーのメールが表示されます。

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

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