Microsoft Graph Toolkit の概要

2024-11-07

注意

Microsoft Graph Toolkit は非推奨です。 2025 年 9 月 1 日から、2026 年 8 月 28 日に完全な退職が予定されています。開発者は、Web エクスペリエンスを構築するために、Microsoft Graph SDK またはその他のサポートされている Microsoft Graph ツールを使用して移行する必要があります。詳細については、非推奨のお知らせを参照してください。

Microsoft Graph ツールキットは、Microsoft Graph にアクセスして操作するための、再利用可能でフレームワークに依存しないコンポーネントと認証プロバイダーのコレクションです。コンポーネントは、Microsoft Graph で認証してデータをフェッチする組み込みプロバイダーを使用して、すぐに機能します。

Microsoft Graph ツールキットを使用すると、アプリケーションで Microsoft Graph を簡単に使用できます。次の例では、 Login コンポーネントと Agenda コンポーネントを使用して、サインインしているユーザーとその予定表イベントを 2 行のコードだけで表示します。

HTML
React

mgt.dev でこの例を開きます。

Microsoft Graph Toolkit を使用する理由

Microsoft Graph Toolkit を使用すると、Microsoft Graph を利用した一般的なエクスペリエンスを独自のアプリケーションに迅速かつ簡単に統合できます。ツールキット:

開発時間を削減します。 Microsoft Graph API に接続し、Microsoft 365 エクスペリエンスのように見える UI でデータをレンダリングする作業は、カスタマイズは必要ありません。
どこでも動作します。すべてのコンポーネントは Web 標準に基づいており、最新のブラウザーと Web フレームワーク (React、Angular、Vue など) とシームレスに連携します。
美しいですが、柔軟です。コンポーネントは、Microsoft 365 エクスペリエンスのように見える設計になっていますが、 CSS のカスタムプロパティとテンプレートを使用してカスタマイズすることもできます。

誰がそれを使用する必要がありますか?

Microsoft Graph Toolkit は、次のような Microsoft Graph からデータに接続してアクセスするアプリを開発するすべてのエクスペリエンスレベルの開発者に最適です。

Web アプリケーション
[Microsoft Teams] タブ
プログレッシブ Web アプリ (PWA)
Electron アプリ
SharePoint Web パーツ

Microsoft Graph Toolkit の内容

コンポーネント

Microsoft Graph Toolkit には、Microsoft Graph API を搭載した最も一般的に構築されたエクスペリエンス用の Web コンポーネントのコレクションが含まれています。

コンポーネントは、React コンポーネントとしても使用できます。

コンポーネント	説明
Agenda	ユーザーまたはグループの予定表にイベントを表示します。
チャット (プレビュー)	Microsoft Teamsからの 1:1 またはグループ会話を表示します
ファイル	アイコン、ファイル名、作成者などを含むファイルまたはフォルダーを表します。
ファイル一覧	複数のファイルまたはフォルダーの一覧を表示します。
Get	HTML 内の任意の Microsoft Graph APIに対して直接 GET クエリを実行できます。
ログイン	Microsoft ID プラットフォームでユーザーを認証し、サインイン時にユーザーのプロファイル情報を表示するためのボタンとポップアップコントロール。
新しいチャット (プレビュー)	Microsoft Teamsで新しい 1:1 またはグループ会話を作成するフォーム
People	写真やイニシャルでユーザーまたは連絡先のグループを表示します。
People ピッカー	ユーザーを検索し、結果の一覧を表示します。
人物	写真、名前、メールアドレスで、ユーザーまたは連絡先を表示します。
人物カード	ユーザーに関するより多くのプロファイル情報を表示するためにユーザーコンポーネントで使用されるポップアップ。
ピッカー	リソースの配列から 1 つのリソースを選択できるドロップダウンコントロールをレンダリングします。
Planner タスク	Microsoft Plannerまたは Microsoft To Do からのタスクの追加、削除、完了、または編集を表示および有効にします。
[検索ボックス]	Microsoft Teamsチャネルを検索して、結果のレンダリングされた一覧からチャネルを選択します。
検索結果	HTML で直接 Microsoft Graph の検索エンドポイントに対してクエリを実行できます。
分類ピッカー	分類ピッカーコンポーネントを使用して、Microsoft Graph APIに分類についてクエリを実行し、用語を含むドロップダウンコントロールをレンダリングします。
Teams チャネルピッカー	Microsoft Teamsチャネルを検索して、結果のレンダリングされた一覧からチャネルを選択します。
To Do	Microsoft To Do からのタスクの追加、削除、完了、または編集を表示および有効にします。

プロバイダー

プロバイダーは、認証を有効にし、さまざまなプラットフォームでアクセストークンを取得するための実装を提供し、Microsoft Graph API を呼び出すための Microsoft Graph クライアントを公開します。コンポーネントは、プロバイダーで使用する場合に最適に機能しますが、プロバイダーは独自に使用できます。

プロバイダー	説明
Custom	アプリケーションの既存の認証コードを使用して、Microsoft Graph への認証とアクセスを有効にするカスタムプロバイダーを作成します。
電子	電子アプリ内のコンポーネントへの Microsoft Graph アクセスを認証して提供します。
MSAL2	msal-browser を使用してユーザーにサインインし、Microsoft Graph で使用するトークンを取得します。
プロキシ	バックエンドを介して Microsoft Graph へのすべての呼び出しをルーティングすることで、バックエンド認証を使用できるようにします。
SharePoint	SharePoint Web パーツ内のコンポーネントへの Microsoft Graph アクセスを認証して提供します。
TeamsFx	Microsoft Teams アプリケーション内の TeamsFx プロバイダーを使用して、Microsoft Graph Toolkit コンポーネントに Microsoft Graph へのアクセスを提供します。