前提
個人用Microsoftアカウントを利用
Graph Explorer からリクエストしてみる
APIを試すだけなら、Graph Explorer からすぐに試すことができる。
- OneNote → GET 自分のノートブック をクリック
- Modify Permissions で Notes.Read を許可する
- Run query
Azure AD アプリケーションを作成する
- Azure Portal にアクセスする
- Microsoft Entra ID → アプリの登録 → 新規登録
- 「サポートされているアカウントの種類」 は 「個人用 Microsoft アカウントのみ」 を選択する
- リダイレクトURI に Postman のコールバックURL
https://oauth.pstmn.io/v1/callbackを設定する
シークレットを作成する
- 管理 → 証明書とシークレット → 新しいクライアント シークレット作成
- シークレット値をコピーする
APIの設定をする
- API のアクセス許可 → アクセス許可の追加 → Notes.Read を選択する
Postman で認可の設定をする
- Authorization を選択する
- 以下の項目を設定する
- GET New Access Token をクリックする
- ブラウザで許諾を求められるので、内容を確認し、許諾する
- トークンが発行される
- Use Token をクリックする
Postman の Authorization 設定項目
| 設定項目 | 値 |
|---|---|
| Type | OAuth 2.0 |
| Grant Type | Authorization Code |
| Callback URL | デフォルトの https://oauth.pstmn.io/v1/callback |
| Auth URL | https://login.microsoftonline.com/consumers/oauth2/v2.0/authorize |
| Access Token URL | https://login.microsoftonline.com/consumers/oauth2/v2.0/token |
| Client ID | アプリの概要から確認できるアプリケーション(クライアント)ID |
| Client Secret | コピーしたシークレット値 |
| Scope | https://graph.microsoft.com/User.Read https://graph.microsoft.com/Notes.Read |
OneNote API をリクエストする
GET https://graph.microsoft.com/v1.0/me/onenote/notebooks をリクエストし、ノートブックの一覧を取得する。
