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

Graph エクスプローラー は、Microsoft Graph API を探索するための開発者ツールです。 次の場合に使用します。

• サンプル テナントで API をテストし、使用可能なリソースを調べる。
• アプリのシナリオのプロトタイプを作成するために、独自のテナントにサインインします。
• さまざまな API に必要なアクセス許可について説明します。
• クエリの Microsoft Graph Toolkit コンポーネント、アダプティブ カード、コード スニペットについて説明します。

開始するには、ブラウザーの Graph エクスプローラーに移動します。

サンプル クエリを調べる

事前構築済みのサンプル クエリを実行して、API のしくみを確認できます。 [ 自分のプロファイルの取得] などのサンプル クエリを選択して、要求と応答を表示します。

その他の機能にサインインする

サインインせずに Graph エクスプローラーを使用できます。 サインインするユーザーは、独自のテナントにアクセスし、より高度な操作を実行できます。 POST、PUT、PATCH、DELETE の各要求を試すには、Microsoft 365 アカウントでサインインします。

運用データに影響を与える可能性のある操作を実行しないように、運用 テナントではなく Microsoft 365 開発者サンドボックス テナントにサインインすることをお勧めします。

重要

組織のアカウントでサインインする場合、Graph エクスプローラーで書き込み要求を実行すると、テナント内のデータに影響する可能性があります。

最初のクエリを実行する

Graph エクスプローラーでクエリを実行するには:

1. サンプル クエリを選択するか、要求フィールドにクエリを入力します。
2. クエリに必要に応じて、要求本文と要求ヘッダーを編集します。 たとえば、Post 要求を実行するには、HTTP 動詞のドロップダウン リストで [POST] を選択し、必要に応じて要求本文と要求ヘッダーを追加します。
3. [クエリの実行] を選択します。 応答が [応答プレビュー] セクションに表示されます。 これには、HTTP 状態コードと API によって返されるデータが含まれます。
4. [応答プレビュー] タブの横には、クエリに関連する応答ヘッダー、コード スニペット、Toolkit コンポーネント、アダプティブ カードも表示できます。

アクセス許可の変更

一部のクエリでは、特定のアクセス許可が必要です。 アクセス許可が不足しているためにクエリが失敗した場合は、エラー メッセージが表示されます。 アクセス許可に同意するには、以下の操作を行います。

1. [ アクセス許可の変更 ] を選択して、必要なアクセス許可に同意します。
2. クエリをもう一度実行します。
3. プロファイルのアバターを選択し、[ アクセス許可に同意する] を選択することもできます。 使用可能なすべてのアクセス許可の一覧から、必要なアクセス許可に同意します。

アプリケーションに適した API を見つける

[ リソース ] タブとドキュメント機能を使用して、アプリケーションに適した API を見つけます。

[リソース] タブ

[ リソース ] タブを使用して、ベータおよび v1.0 エンドポイントの Microsoft Graph リソースの一覧を参照するか、検索バーを使用して特定のリソースを検索します。

コレクションに追加する特定のクエリを選択することもできます。 リソースの追加が完了したら、[ コレクションのプレビュー] を選択します。 コレクション ビューから、選択したリソースを確認、削除、ダウンロードできます。

ドキュメントのリンク

API エンドポイントの詳細については、各クエリの [ドキュメント] を選択します。 関連する API リファレンスでは、要求パラメーター、応答構造、および必要なアクセス許可に関する詳細情報が提供されます。

Microsoft Graph API をアプリケーションに統合する

Graph エクスプローラーで次の機能を使用して、Microsoft Graph API をアプリケーションに統合します。

コード スニペット

クエリを実行した後、[ コード スニペット ] タブを選択して、好みの言語 (C#、JavaScript、Java、Go、PowerShell) で同じ操作を実行する方法を確認します。

Toolkit コンポーネント

Microsoft Graph Toolkit には、Microsoft Graph で認証およびデータをフェッチする組み込みプロバイダーを備えた、再利用可能なフレームワークに依存しない Web コンポーネントとヘルパーが用意されています。

Graph エクスプローラー のツールキット コンポーネントを使用すると、API クエリに対応する Microsoft Graph Toolkit コンポーネントを視覚化できます。 [ツールキット コンポーネント] タブの青いドットは、現在指定されている REST API クエリで使用できるコンポーネントを示します。 コンポーネントのコードをアプリに簡単にコピーできます。

アダプティブ カード

アダプティブ カード は、アプリとサービスがオープンに交換できる、JSON で作成されたプラットフォームに依存しない UI スニペットを提供します。 [アダプティブ カード] タブの青いドットは、選択したクエリでアダプティブ カードを使用できる状態であることを示します。

その他の Graph エクスプローラー機能

Graph エクスプローラーを最大限に活用するには、ツールの次の追加機能を理解してください。

履歴

[ 履歴] を選択して、過去 30 日間に実行されたクエリにアクセスしてエクスポートします。

Settings

右上の設定アイコンを使用して、Graph エクスプローラー UI をカスタマイズできます。 サイドバーを展開、折りたたみ、サイズ変更することもできます。

共有

現在のクエリを共有するには、[共有] を選択して、ユーザーが Graph エクスプローラーで特定のクエリを試すことができるようにします。

関連コンテンツ

• Graph エクスプローラーで作業を行う
• GitHub で投稿またはフィードバックを提供する