Microsoft Graph の概要

Microsoft Graph は、Microsoft Entra や Microsoft 365 などの Microsoft クラウド サービスにおけるデータとインテリジェンスへのゲートウェイです。 Microsoft Graphを通じてアクセスできる豊富なデータを使用して、何百万人ものユーザーと対話する組織やコンシューマー向けのアプリを構築します。

Microsoft Graph API、Copilot コネクタ、Data Connect が Microsoft 365 プラットフォームにどのように電力を供給するかを示す図。

Microsoft 365 プラットフォームを向上させるデータとサービス

Microsoft 365 プラットフォームでは、次の 3 つの主要コンポーネントによってデータ アクセスとフローが有効になります。

  • Microsoft Graph API は、単一のエンドポイントと https://graph.microsoft.com を提供し、Microsoft 365、Windows、Enterprise Mobility + Security など、Microsoft クラウド内の ユーザーを中心にした豊富なデータと洞察へのアクセスを提供します。 REST API または SDK を使用してエンドポイントにアクセスし、Microsoft 365 シナリオ用のアプリを構築します。 これらのシナリオは、生産性、コラボレーション、教育、人と職場のインテリジェンスなどです。 また、Microsoft Graph には、ユーザー ID/デバイス ID、アクセス、コンプライアンス、セキュリティを管理し、データの漏洩や損失から組織を保護する強力なサービスが含まれています。
  • Microsoft 365 Copilot コネクタ (旧称 Microsoft Graph コネクタ) は受信方向で動作し、Microsoft クラウド外部のデータを Microsoft Graph サービスおよびアプリケーションに配信して、Microsoft Search などの Microsoft 365 エクスペリエンスを強化します。 コネクタは、Box、Google Drive、Jira、Salesforce など、多くの一般的に使用されるデータ ソースに対して存在します。
  • Microsoft Graph Data Connect には、一般的な Azure データ ストアへのMicrosoft Graph データの安全でスケーラブルな配信を効率化するための一連のツールが用意されています。 キャッシュされたデータは、インテリジェントなアプリケーションを構築する際に使用できる Azure 開発ツールのデータ ソースとして機能します。

Microsoft Graph API、コネクタ、およびデータ接続を組み合わせることで、Microsoft 365 プラットフォームを強化します。 Microsoft Graph データおよびその他のデータセットにアクセスすることで、洞察と分析を導き出し、Microsoft 365 のエクスペリエンスを拡張したり、独自のインテリジェントなアプリケーションを構築したりすることができます。

Microsoft Graph の内容

Microsoft Graph は、次の Microsoft クラウド サービスのデータにアクセスするための REST API とクライアント ライブラリを公開しています。

  • Microsoft 365 のコア サービス: Bookings、カレンダー、Excel、Microsoft Purview eDiscovery、Microsoft Search、OneDrive、OneNote、Outlook/Exchange、People (Outlook 連絡先)、Planner、SharePoint、Teams、To Do、Viva Insights
  • Enterprise Mobility + Security サービス: Advanced Threat Analytics、高度な脅威保護、Microsoft Entra、Identity Manager、Intune
  • Windows サービス: アクティビティ、デバイス、通知、ユニバーサル印刷 (プレビュー)
  • Dynamics 365 Business Central サービス
  • Microsoft パートナー センター サービス

詳細については、「Microsoft Graph の主要なサービスおよび機能」を参照してください。

Microsoft Graph の一部である主要なリソースとリレーションシップを示す図

Microsoft Graph でできること

Microsoft Graph を使用すると、ユーザーの固有のコンテキストに関するエクスペリエンスを構築し、生産性を高めることができます。 次のアプリを想像してみてください。

  • 出席者にプロファイル情報を提供することで、次の会議の調査や準備に役立ちます。情報には、出席者の役職やマネージャー、作業中の最新のドキュメントおよび共同作業する人に関する情報などが含まれます。
  • 予定表をスキャンして、次のチームミーティングに最適な時間を提案します。
  • OneDrive の Excel ファイルから最新の売上予測チャートを取得し、リアルタイムで予測を更新します。これらをすべて携帯電話から行います。
  • 予定表の変更をサブスクライブし、会議に多くの時間を費やしている場合にアラートを送信し、出席者の関連性に基づいて見逃したり委任したりできる推奨事項を提供します。
  • たとえば、個人の OneDrive に送信する必要のある写真と OneDrive for Business に送信する必要のあるビジネスの領収書を分類するなどにより、携帯電話で個人情報や仕事情報を整理するのに役立ちます。
  • 意思決定者がビジネス生産性を向上させる時間の割り当てとコラボレーション パターンに関する貴重な洞察を引き出すことができるように、大規模な Microsoft 365 データを分析します。
  • カスタム ビジネス データを Microsoft Graph に取り込み、インデックスを作成して Microsoft 365 サービスからのデータと共に検索できるようにします。

例として、会議出席者の調査に関する最初のシナリオを選択してください。 Microsoft Graph API を使用すると、次のことが可能になります。

  1. 会議イベント参加者のメール アドレスを取得します。
  2. Microsoft Entra ID でユーザーとして個別に検索し、プロファイル情報を取得します

次に関係を使用して他のリソースに移動できます。

詳細については、統合パターンに関するページを参照してください。

Microsoft Graph はセキュリティで保護されており、承認された呼び出し元のみがデータにアクセスできます。 詳細については、認証と承認に関するページを参照してください。

注:

Microsoft Graph API を使用する場合、「Microsoft API の使用条件」と「Microsoft プライバシー ステートメント」に同意するものとします。

Microsoft Graph API を使用するための一般的なシナリオをいくつか確認します。 リンクから Graph エクスプローラーに移動できます。

操作 URL
自分のプロファイルの取得 https://graph.microsoft.com/v1.0/me
自分のファイルの取得 https://graph.microsoft.com/v1.0/me/drive/root/children
自分の写真の取得 https://graph.microsoft.com/v1.0/me/photo/$value
自分のメールの取得 https://graph.microsoft.com/v1.0/me/messages
自分にとって重要度の高いメールの取得 https://graph.microsoft.com/v1.0/me/messages?$filter=importance%20eq%20'high'
自分の予定表イベントの取得 https://graph.microsoft.com/v1.0/me/events
自分の上司の取得 https://graph.microsoft.com/v1.0/me/manager
foo.txt ファイルを最後に変更したユーザーの取得 https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser
自分がメンバーの Microsoft 365 グループの取得 https://graph.microsoft.com/v1.0/me/memberOf/$/microsoft.graph.group?$filter=groupTypes/any(a:a%20eq%20'unified')
自分の所属組織のユーザーの取得 https://graph.microsoft.com/v1.0/users
自分の組織内のグループの取得 https://graph.microsoft.com/v1.0/groups
自分に関連付けられたユーザーの取得 https://graph.microsoft.com/v1.0/me/people
自分の周りで人気上昇中の項目の取得 https://graph.microsoft.com/beta/me/insights/trending
自分のノートの取得 https://graph.microsoft.com/v1.0/me/onenote/notebooks

外部コンテンツ ソースから Microsoft Graph にデータを取り込む

Copilot コネクタを使用して、Microsoft クラウドの外部のデータを Microsoft Graph に取り込みます。 このようなデータには、たとえば、オンプレミスやパブリック クラウド、またはプライベート クラウドでホストされる組織の人事データベースや製品カタログなどがあります。

Copilot コネクタは、外部データ ソースへの接続を作成し、データのインデックスを作成し、外部のカスタム項目とファイルとして保存します。 インデックスが作成されると、これらのアイテムは Microsoft Search 内と、Microsoft Search API を使用するアプリに表示できます。

Microsoft Graph への大量アクセス

Microsoft Graph データ接続を使用すると、管理者が Microsoft Graph データに対してきめ細かな同意と完全な制御を行いながら、Microsoft Graph 上のデータに大規模にアクセスできます。 データ接続により、このデータの Microsoft Azure への配信が効率化されます。

Azure ツールを使用すると、次のようなインテリジェント アプリを構築できます。

  • organizationで最も近い分野の専門家を見つけます。
  • ナレッジ ベース作成を自動化します。
  • 会議室の使用状況に関する洞察を得るために、会議出席依頼を分析します。
  • 生産性および通信のデータから不正行為を検出します。

Microsoft Graph API またはデータ接続を使用するタイミング

Microsoft Graph Data Connect を使用すると、Microsoft Graph API を介して使用できるデータを操作できます。 Data Connect には、インテリジェント なアプリケーションの構築を合理化するためのツールが用意されています。すべて Microsoft クラウド内にあります。

機能 Microsoft Graph API Microsoft Graph データ接続
アクセス スコープ 1 人のユーザーまたはテナント全体 多数のユーザーまたはグループ
アクセス パターン リアルタイム 定期的なスケジュール
データ操作 ソース データを操作する データのキャッシュに対する操作
データ保護 データは、Microsoft 365 や Microsoft Entra などのソース サービス内で保護されます データ保護対象は Azure サブスクリプション内のデータのキャッシュにも拡大される
ユーザーの同意 自分
リソースの種類
なし
管理者の同意 組織全体
リソースの種類
ユーザーのグループを選択
リソースの種類とプロパティ
ユーザーを除外
アクセス ツール RESTful Web クエリ Azure Data Factory

サンプル アプリを試す

クイック スタートを使用して、すぐに実行できるサンプル アプリを設定します。