Microsoft Graph API で Postman を使用する

Microsoft Graph Postman のコレクションを使用して、Microsoft Graph API をすぐに開始できます。

Postman の画像

この記事では、Postman と Microsoft Graph の使用方法について説明します。 Graph Explorer を使用して、web ブラウザーで直接 Microsoft Graph API を検索することもできます。

これを行う方法の詳細については、この記事の手順に従うか、Microsoft Graph Postman ワークスペースの使用の開始 ビデオをご覧ください。

ステップ 1 - Microsoft Graph Postman コレクションをフォークする

Postman コレクションを使用するには、Postman コレクションを独自の Postman ワークスペースにフォークします。 Web ブラウザからこれを行います。

  1. Postman に移動し、サインインします。
  2. Microsoft Graph というラベルの付いた Postman コレクションに移動します。
  3. 自分のフォークのラベルに記入します。 これは任意のテキストで作成できます。
  4. [ワークスペース] で、ドロップダウン リストで [マイ ワークスペース] が選択されていることを確認します。
  5. [フォーク コレクション] をクリックします。

自分のワークスペースにあるメインの Microsoft Graph Postman コレクションのフォークにリダイレクトされます。

ステップ 2 - (オプション - Postman Web ブラウザのみ) Postman Agent をダウンロードする

この特定の Postman コレクションを Web ブラウザで使用するには、Postman デスクトップ エージェント をダウンロードします。 Web ブラウザの CORS 制限により、これがないと Postman を Web に使用できません。

Postman for Windows アプリを使用している場合は、エージェントは必要ありません。 Postman for Windowsを開くと、ワークスペースにこのフォークされたコレクションが表示されます。

ステップ 3 - Azure AD アプリケーションを作成する

独自の開発者テナントでこのコレクションを使用するには、Azure AD アプリケーションを作成し、呼び出すリクエストに適切なアクセス許可を付与します。 開発者テナントがない場合は、Microsoft 365 開発者プログラムからサイン アップできます。

  1. portal.azure.com に移動し、開発者テナント管理者アカウントでサインインします。
  2. [Azure サービス] で、[Azure Active Directory] をクリックします。
  3. 左側のメニューで、[アプリの登録] をクリックします。
  4. 水平メニューで、[新規登録] をクリックします。
  5. [アプリケーション名]Postmanに設定します。
  6. [リダイレクト URI]https://oauth.pstmn.io/v1/browser-callbackに設定します。
  7. [登録] をクリックします。
  8. 左側のメニューで、[API アクセス許可] をクリックします。
  9. 水平メニューで、[アクセス許可の追加] をクリックし、[Microsoft Graph] を選択してから、[委任されたアクセス許可] を選択します。
  10. Mail.と入力し、[メール] オプションを展開して、Mail.Read を確認します。
  11. [アプリケーションのアクセス許可] をクリックしてUser.を入力し、[アプリケーションのアクセス許可] を確認します。
  12. ユーザー オプションを展開し、User.Read.All をチェックします。
  13. [アクセス許可を追加する] をクリックします。
  14. 水平メニューで、[管理者の同意を付与する] をクリックし、[はい] をクリックします。
  15. 左側のメニューで、[概要] をクリックします。 ここから、アプリケーション (クライアント) IDディレクトリ (テナント) ID を取得できます。 これらの情報は、手順 4 で必要になります。
  16. 左側のメニュー バーで、[証明書と機密情報] をクリックします。
  17. [新しいクライアント シークレット] を選択し、説明を入力して [追加] を選択します。 新しいクライアント シークレット にカーソルを合わせてコピーします。 この値は、手順 4 で必要になります。

Azure AD アプリケーションには、ユーザーに代わって Mail.Read を呼び出すように要求したり、User.Read.All のアプリケーションとして要求したりするためのアクセス許可があります。

ステップ 4 - Postman における認証の構成

このステップでは、アクセス トークンの取得に使用する環境変数を設定します。

  1. [フォーク環境] に移動します。
  2. フォークのラベルを追加します。 これは任意のテキストで作成できます。
  3. [ワークスペース] で、ドロップダウン リストで [マイ ワークスペース] が選択されていることを確認します。
  4. [フォーク環境] をクリックします。
  5. ClientID で、現在の値 を手順 3.15 のアプリケーション (クライアント) ID 値に設定します。
  6. ClientSecret で、現在の値 を手順 3.17 のクライアント シークレット値に設定します。
  7. TenantID と呼ばれる新しい変数を作成し、現在の値 を手順 3.15 のディレクトリ (テナント) ID 値に設定します。
  8. 右上にある [保存] をクリックします。
  9. [環境の管理] タブを閉じます。
  10. 右上の目のアイコンの横で、[環境なし] ではなく [M365 環境] がドロップダウンで選択されていることを確認します。

ステップ 5 - 委任されたアクセス トークンを取得する

委任された認証フローとしてリクエストを実行するのはこれが初めてなので、アクセス トークンを取得する必要があります。

  1. [委任済み] フォルダーにカーソルを合わせ、省略記号をクリックして、[編集] を選択します。
  2. [承認] タブをクリックします。
  3. 右下にスクロールして、[新しいアクセス トークンを取得] をクリックします。
  4. 開発者テナント管理者アカウントでサインインします。
  5. [続行] をクリックし、[トークンを使用] ボタンをクリックします。
  6. ダイアログ ボックスの右側で、[更新] をクリックします。

これで、委任されたリクエストに使用する有効なアクセス トークンができました。

ステップ 6 - 最初の委任されたリクエストを実行する

[委任済み] フォルダー内には、呼び出すことができるさまざまな Microsoft Graph ワークロードの要求があります。

  1. [委任済み] フォルダーを展開し、[メール] フォルダーを展開します。
  2. [メッセージを取得] をダブルクリックして、リクエストを開きます。
  3. 右上にある [送信] をクリックします。

これで、委任された認証を使用して Microsoft Graph 呼び出しを正常に行うことができました。

ステップ 7 - アプリケーション アクセス トークンを取得する

アプリケーション認証フローとしてリクエストを実行するのはこれが初めてなので、アクセス トークンを取得する必要があります。

  1. [アプリケーション] フォルダーにカーソルを合わせ、省略記号をクリックして、[編集] を選択します。
  2. [承認] タブをクリックします。
  3. 右側にスクロールして、[新しいアクセス トークンを取得] をクリックします。
  4. [続行] をクリックし、[トークンを使用] ボタンをクリックします。
  5. ダイアログの右下で、[更新] をクリックします。

これで、アプリケーション リクエストに使用する有効なアクセス トークンができました。

ステップ 8 - 最初の委任されたリクエストを実行する

[アプリケーション] フォルダー内には、呼び出すことができるさまざまな Microsoft Graph ワークロードの要求があります。

  1. [アプリケーション] フォルダーを展開してから、[ユーザー] フォルダーを展開します。
  2. [ユーザーを取得] をダブルクリックして、リクエストを開きます。
  3. 右上にある [送信] をクリックします。

これで、アプリケーション認証を使用して Microsoft Graph 呼び出しを正常に行うことができました。

次の手順に従って、Microsoft Graph に他の要求を行うことができます。他のリクエストを機能させるには、Azure AD アプリケーションにアクセス許可を追加する必要があることに注意してください。そうしないと、応答で許可拒否エラーが発生します。

コレクションに付与する

独自の要求を投稿する場合は、Postman ライセンスが必要です。 フォークされたコレクションに変更を加えてから、コレクションの最上位ノードにカーソルを合わせて、[プル要求の作成] を選択できます。

関連項目

これを行う方法の詳細については、Microsoft Graph Postman コレクションの使用の開始 ビデオをご覧ください。