Microsoft Graph ツールキットとは
Web アプリを作成し、Microsoft 365 に接続する場合、承認を実装し、Microsoft Graph に電話して、Microsoft 365 に保存されているデータを取得する必要があります。
このプロセスを簡略化するために、Microsoft Graph Toolkit は Web アプリを Microsoft 365 に接続するための Web コンポーネントと認証プロバイダーのセットを提供します。
このユニットでは、Microsoft Graph Toolkit の概要と、それを使用する理由について説明します。 また、Toolkit を使用できるさまざまな種類のアプリについても説明します。
Microsoft Graph Toolkit の概要
Microsoft Graph Toolkit は、任意のJavaScript フレームワークを使用してアプリを Microsoft 365 に接続するために使用する Web コンポーネントのセットです。 アプリで Toolkit を読み込むと、カスタムの HTML タグのセットにアクセスできます。 これらのタグを使用すると、Microsoft 365 からデータを読み込むことができます。
たとえば、現在のユーザーの今後の会議の一覧を表示するには、次のコード スニペットをアプリに含めます。
<mgt-agenda></mgt-agenda>
その後、アプリは次を表示します。
Microsoft Graph Toolkit では、新しいコンポーネントと機能が定期的に更新されます。
Microsoft Graph Toolkit を使用する理由は?
前の例では、Web リクエストを 1 つも発行する必要がなかったことに気が付きましたか? これが、まさに Microsoft Graph Toolkit の使用を検討する必要がある理由です。
- 独自の Web アプリの構築に焦点を当てる: Microsoft Graph Toolkit は、Microsoft Graph の承認と接続を省略しています。 承認、Web 要求の作成、応答の処理、例外処理について心配する必要はありません。
- Web アプリに合わせてレンダリングをカスタマイズする: すべての Microsoft Graph Toolkit コンポーネントはすぐに使用できます。 既定では、Fluent UI (Microsoft 365 のデザイン言語) を使用してデータが表示されます。 各コンポーネントはテンプレートも公開します。これにより、ユーザーはデータのレンダリングをカスタマイズできます。
Microsoft Graph Toolkit をいつ使用しますか?
Microsoft Graph Toolkit は、Microsoft 365 用の Web アプリや拡張機能を作成するときに使用できます。
- Web アプリで Microsoft Graph Toolkit を使用する: Microsoft Graph Toolkit は Web アプリケーションで使用する場合に最適です。 最小限の構成では、ユーザーは Microsoft 365 アカウントでアプリにサインインできます。 さまざまなコンポーネントを使用して、Microsoft 365 から直接データを読み込み、アプリの価値を向上できます。
- Microsoft Graph Toolkit を使用して Microsoft 365 の拡張機能を作成する: Microsoft Graph Toolkit は、Teams タブや SharePoint Framework Web パーツなど、Microsoft 365 の拡張機能を作成する場合にも使用できます。 これらの拡張機能を構築するために、Toolkit には、Microsoft 365 によって公開されている既存の認証情報を使用するプロバイダーが用意されています。
- 任意の JavaScript フレームワークで Microsoft Graph Toolkit を使用する: Microsoft Graph Toolkit Web コンポーネントは任意の JavaScript フレームワークで動作します。 React を使用して Web アプリを作成する場合、React 用に作成された特定の Toolkit パッケージがあります。 このパッケージでは、Toolkit のコンポーネントが React コンポーネントに含まれており、複雑なデータをコンポーネントに渡し、イベント ハンドラーを構成する作業が簡単になります。
Web アプリで Microsoft Graph Toolkit を読み込む
Web アプリを作成し、バンドル ツールを使用しない場合は、コンテンツ配信ネットワークから Microsoft Graph Toolkit を直接読み込むことができます。 コンテンツ配信ネットワークから Toolkit を読み込むには、次のコード スニペットを Web アプリに追加します。
<script src="https://unpkg.com/@microsoft/mgt@3/dist/bundle/mgt-loader.js"></script>
npm のようなパッケージ マネージャーを使用するプロジェクトを行う場合は、@microsoft/mgt パッケージをインストールして、Microsoft Graph Toolkit を Web アプリに追加します。
npm install @microsoft/mgt
React アプリを作成する場合は、代わりに @microsoft/mgt-react パッケージをインストールします。
npm install @microsoft/mgt-react