Graph エクスプローラーを使用して Microsoft Graph API を試す

Graph エクスプローラーは、Microsoft Graph REST API リクエストを簡単に作成し、対応するレスポンスを表示できる開発者ツールです。 Graph エクスプローラーを使用して、既定のサンプル テナントで API を試して機能を探索するか、独自のテナントにサインインして、アプリのシナリオを実現するためのプロトタイピング ツールとして使用します。 このツールには、コード スニペット (C#、Java、JavaScript)、Microsoft Graph Toolkit、アダプティブ カードの統合などの便利な機能が含まれています。

Graph エクスプローラーを使用して、次のことを行います。

  • Microsoft Graph API リクエスト (GET、POST、PUT、PATCH、DELETE) を作成し、応答コードとヘッダーおよび本文を含むレスポンスを確認します。
  • アクセス許可への同意。 Graph エクスプローラーは、委任されたアクセス許可のみをサポートします。
  • 要求本文と要求ヘッダーをクエリに追加します。
  • アクセス トークンを表示してコピーします。
  • Microsoft Graph でさまざまなサービスのサンプル クエリを表示します。
  • 過去 30 日間に実行したクエリを表示、ダウンロード、または削除します。
  • C#、Java、JavaScript で実行する各クエリのコード スニペットを表示してコピーします。
  • 一部のサンプル クエリについては、Microsoft Graph ツールキット コンポーネントとアダプティブ カードにアクセスします。
  • 要求本文と要求ヘッダーを含むクエリを共有します。

Graph エクスプローラーが認証プロセスを処理します。 サイド バーを折りたたんだり、テーマを変更したりして、エクスペリエンスをカスタマイズします。

作業の開始

Graph エクスプローラーは、Microsoft Graph 開発者センターでホストされている Web アプリケーションです。 これはオープンソース プロジェクトであり、GitHub リポジトリでの投稿とフィードバックを歓迎します。

Graph エクスプローラーには、次の要素が含まれています。

  1. HTTP 動詞のドロップダウン リスト
  2. API バージョンのドロップダウン リスト
  3. クエリ アドレス バーの要求
  4. サンプル クエリ
  5. サンプル クエリのドキュメント リンク

Graph エクスプローラーのユーザー インターフェイスのスクリーンショット。

Graph エクスプローラーで GET 要求を作成する

Graph エクスプローラーで GET 要求を実行するために、サインインする必要はありません。 サンプル クエリをクリックするだけで、サンプル データが応答プレビューに表示されます。

Graph エクスプローラーのサンプル要求のスクリーンショット。

要求するには:

  1. サンプル クエリを選択して実行します。
  2. HTTP 応答コードを取得します。
  3. サンプル データを使用して、Microsoft Graph API からの応答を表示します。

Graph エクスプローラーにサインインして同じクエリを選択すると、サインインしたテナントからの実際のデータを含む応答が返されます。

Graph エクスプローラーでの非 GET 要求を実行する

POST、PUT、PATCH、および DELETE 要求を試すには、Microsoft 365 アカウントを使用して Graph エクスプローラーにサインインします。 これは、テストまたはデモンストレーションを目的とした組織のアカウントにすることができます。 無料のサンプル Microsoft 365 E5 開発者向けサブスクリプション、および Microsoft 365 プラットフォームのソリューションの構築に役立つツールやその他のリソースを入手するには、Microsoft 365 開発者プログラムに参加します。

重要

組織アカウントを使用してサインインすることを選択した場合、非 GET 要求を実行すると、テナントのデータに影響を与える可能性があります。

たとえば、POST 要求を実行するには、HTTP 動詞のドロップダウン リストで [POST] を選択し、必要に応じて要求本文と要求ヘッダーを追加します。

Graph エクスプローラーの POST 要求のスクリーンショット。

  1. POST サンプル クエリを選択します。
  2. 要求本文 の更新; たとえば、アプリケーションに名前を付けます。
  3. [クエリの実行] を選択します。
  4. サンプル データを使用して、Microsoft Graph API からの応答を参照します。

既定の JSON 以外の形式で応答を表示するには、要求ウィンドウで [要求ヘッダー] タブを選択し、キーと値のペアを定義して、[追加] を選択します。

Graph エクスプローラーの [要求ヘッダー] タブを示すスクリーンショット。

次の手順