Microsoft Graph の概要Overview of Microsoft Graph

Microsoft Graph は、Microsoft 365 のデータとインテリジェンスにアクセスするための入り口です。Microsoft Graph is the gateway to data and intelligence in Microsoft 365. これは、Office 365、Windows 10、およびEnterprise Mobility + Securityの大量のデータにアクセスする際に使用できる統合型プログラミング モデルを提供します。It provides a unified programmability model that you can use to access the tremendous amount of data in Office 365, Windows 10, and Enterprise Mobility + Security. Microsoft Graph の豊富なデータを使用して、数百万人のユーザーを操作する組織やコンシューマー向けのアプリを作成できます。Use the wealth of data in Microsoft Graph to build apps for organizations and consumers that interact with millions of users.

Microsoft 365 プラットフォームの向上Powering the Microsoft 365 platform

Microsoft Graph、Microsoft Graph データ接続、およびMicrosoft Graph コネクタにより、Microsoft 365 のエクスペリエンスを拡張し、インテリジェントなアプリを構築できます。

Microsoft 365 プラットフォームでは、主に次の 3 つのコンポーネントがデータへのアクセスとフローを容易にします。In the Microsoft 365 platform, three main components facilitate the access and flow of data:

  • Microsoft Graph API は、Microsoft 365 サービスのリソースとして公開されている豊富なユーザー中心のデータおよび分析情報にアクセスできるように単一のエンドポイントである https://graph.microsoft.com を提供します。The Microsoft Graph API offers a single endpoint, https://graph.microsoft.com, to provide access to rich, people-centric data and insights exposed as resources of Microsoft 365 services. REST API または SDK を使用して、エンドポイントにアクセスし、生産性、コラボレーション、教育、セキュリティ、ID、アクセス、デバイス管理などのシナリオをサポートするアプリを構築できます。You can use REST APIs or SDKs to access the endpoint and build apps that support scenarios spanning across productivity, collaboration, education, security, identity, access, device management, and much more.
  • Microsoft Graph コネクタ (プレビュー) は着信方向に機能します。Microsoft クラウド外部のデータを Microsoft Graph サービスとアプリケーションに配信し、Microsoft Search などの Microsoft 365 エクスペリエンスを強化します。Microsoft Graph connectors (preview) work in the incoming direction, delivering data external to the Microsoft cloud into Microsoft Graph services and applications, to enhance Microsoft 365 experiences such as Microsoft Search.
  • Microsoft Graph データ接続は、一般的な Azure データ ストアへの Microsoft Graph データの安全かつスケーラブルな配信を合理化できるツール セットを提供します。Microsoft Graph data connect provides a set of tools to streamline secure and scalable delivery of Microsoft Graph data to popular Azure data stores. このキャッシュされたデータは、インテリジェントなアプリケーションを構築する際に使用できる Azure 開発ツールのデータ ソースとして機能します。This cached data serves as data sources for Azure development tools that you can use to build intelligent applications.

Microsoft Graph API、コネクタ (プレビュー)、およびデータ接続を組み合わせることで、Microsoft 365 プラットフォームを強化します。Together, the Microsoft Graph API, connectors (preview), and data connect power the Microsoft 365 platform. Microsoft Graph データおよびその他のデータセットにアクセスして洞察と分析を導き出すことで、Microsoft 365 のエクスペリエンスを拡張したり、独自のインテリジェントなアプリケーションを構築したりすることができます。With the ability to access Microsoft Graph data and other datasets to derive insights and analytics, you can extend Microsoft 365 experiences, or build unique, intelligent applications.

注意

Microsoft Graph コネクタはプレビューです。Microsoft Graph connectors is in preview. Microsoft Search でコネクタを使用するか、コネクタを構築するには、コネクタ プレビュー プログラムにサインアップする必要があります。To use connectors with Microsoft Search or to build connectors, you must sign up for the connectors preview program. プレビュー プログラムに参加するには、まず「Microsoft Graph コネクタ プレビュー サインアップ フォーム」を送信します。To join in the preview program, submit the Microsoft Graph connectors preview signup form.

Microsoft Graph の内容What's in Microsoft Graph?

Microsoft Graph は、次の Microsoft 365 services のデータにアクセスするための REST API とクライアント ライブラリを公開しています。Microsoft Graph exposes REST APIs and client libraries to access data on the following Microsoft 365 services:

  • Office 365 サービス: Delve、Excel、Microsoft Bookings、Microsoft Teams、OneDrive、OneNote、Outlook/Exchange、Planner、およびSharePointOffice 365 services: Delve, Excel, Microsoft Bookings, Microsoft Teams, OneDrive, OneNote, Outlook/Exchange, Planner, and SharePoint
  • Enterprise Mobility + Security サービス: Advanced Threat Analytics、Advanced Threat Protection、Azure Active Directory、Identity Manager、およびIntuneEnterprise Mobility and Security services: Advanced Threat Analytics, Advanced Threat Protection, Azure Active Directory, Identity Manager, and Intune
  • Windows 10 サービス: アクティビティ、デバイス、および通知Windows 10 services: activities, devices, notifications
  • Dynamics 365 Business CentralDynamics 365 Business Central

詳細については、「Microsoft Graph の主要なサービスおよび機能」を参照してください。To find out more, see Major services and features in Microsoft Graph.

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

Microsoft Graph でできることWhat can you do with Microsoft Graph?

Microsoft Graph を使用すると、ユーザーの固有のコンテキストに関するエクスペリエンスを構築し、生産性を高めることができます。Use Microsoft Graph to build experiences around the user's unique context to help them be more productive. 次のアプリを想像してみてください。Imagine an app that...

  • 出席者にプロファイル情報を提供することで、次の会議の調査や準備に役立ちます。情報には、出席者の役職やマネージャー、作業中の最新のドキュメントおよび共同作業する人に関する情報などが含まれます。Looks at your next meeting and helps you prepare for it by providing profile information for attendees, including their job titles and managers, as well as information about the latest documents they're working on, and people they're collaborating with.
  • 予定表をスキャンして、次のチームミーティングに最適な時間を提案します。Scans your calendar, and suggests the best times for the next team meeting.
  • OneDrive の Excel ファイルから最新の売上予測チャートを取得し、リアルタイムで予測を更新します。これらをすべて携帯電話から行います。Fetches the latest sales projection chart from an Excel file in your OneDrive and lets you update the forecast in real time, all from your phone.
  • 予定表の変更に対応し、会議に時間がかかりすぎているときに警告を送信したり、出席者との関連度に基づいて、見逃しや委任が可能な会議を提示したりします。Subscribes to changes in your calendar, sends you an alert when you’re spending too much time in meetings, and provides recommendations for the ones you can miss or delegate based on how relevant the attendees are to you.
  • たとえば、個人の OneDrive に送信する必要のある写真と OneDrive for Business に送信する必要のあるビジネスの領収書を分類するなどにより、携帯電話で個人情報や仕事情報を整理するのに役立ちます。Helps you sort out personal and work information on your phone; for example, by categorizing pictures that should go to your personal OneDrive and business receipts that should go to your OneDrive for Business.
  • 意思決定者がビジネス生産性を向上させる時間の割り当てとコラボレーション パターンに関する貴重な洞察を引き出すことができるように、大規模な Office 365 データを分析します。Analyzes at-scale Office 365 data so that decision makers can unlock valuable insights into time allocation and collaboration patterns that improve business productivity.
  • カスタム ビジネス データを Microsoft Graph に取り込み、インデックスを作成して Microsoft 365 サービスからのデータと共に検索できるようにします。Brings custom business data into Microsoft Graph, indexing it to make it searchable along with data from Microsoft 365 services.

例として、会議出席者の調査に関する最初のシナリオを選択してください。Pick the first scenario about researching meeting attendees as an example. Microsoft Graph API を使用すると、次のことが可能になります。With the Microsoft Graph API, you can:

  1. 会議イベント参加者のメール アドレスを取得します。Get the email addresses of the meeting event attendees.
  2. プロファイル情報を取得するには、Azure Active Directory のユーザーとして個別に検索します。Look them up individually as a user in Azure Active Directory to get their profile information.

次に関係を使用して他のリソースに移動できます。You can then navigate to other resources using relationships:

Microsoft Graph は、適切なアクセス許可がある場合に限り、開発者向けに Microsoft 365 プラットフォームを継続的に公開します。Microsoft Graph continues to open up the Microsoft 365 platform for developers, and always only with the appropriate permissions.

注意

Microsoft Graph API を使用する場合、「Microsoft API 使用条件」と「Microsoft のプライバシーに関する声明」に同意することになります。When you use the Microsoft Graph API, you agree to the Microsoft APIs Terms of Use and the Microsoft Privacy Statement.

Microsoft Graph API を使用するための一般的なシナリオをいくつか確認します。Check out some of these common scenarios for working with the Microsoft Graph API. リンクから Graph エクスプローラーに移動できます。The links take you to the Graph Explorer.

操作Operation URLURL
自分のプロファイルの取得GET my profile https://graph.microsoft.com/v1.0/me
自分のファイルの取得GET my files https://graph.microsoft.com/v1.0/me/drive/root/children
自分の写真の取得 GET my photo https://graph.microsoft.com/v1.0/me/photo/$value
自分のメールの取得GET my mail https://graph.microsoft.com/v1.0/me/messages
自分にとって重要度の高いメールの取得GET my high importance email https://graph.microsoft.com/v1.0/me/messages?$filter=importance%20eq%20'high'
自分の予定表イベントの取得GET my calendar events https://graph.microsoft.com/v1.0/me/events
自分の上司の取得GET my manager https://graph.microsoft.com/v1.0/me/manager
foo.txt ファイルを最後に変更したユーザーの取得GET last user to modify file foo.txt https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser
自分がメンバーになっている Office365 グループの取得GET Office365 groups I’m member of https://graph.microsoft.com/v1.0/me/memberOf/$/microsoft.graph.group?$filter=groupTypes/any(a:a%20eq%20'unified')
自分の所属組織のユーザーの取得GET users in my organization https://graph.microsoft.com/v1.0/users
自分の組織内のグループの取得GET groups in my organization https://graph.microsoft.com/v1.0/groups
自分に関連付けられたユーザーの取得GET people related to me https://graph.microsoft.com/v1.0/me/people
自分の周りで人気上昇中の項目の取得GET items trending around me https://graph.microsoft.com/beta/me/insights/trending
自分のノートの取得GET my notes https://graph.microsoft.com/v1.0/me/onenote/notebooks

外部コンテンツ ソースから Microsoft Graph (プレビュー) にデータを取り込むBring data from an external content source to Microsoft Graph (preview)

Microsoft Graph _コネクタ_を使用して、Microsoft クラウドの外部にあるデータを Microsoft Graph に取り込みます。Use Microsoft Graph connectors to bring data that is external to the Microsoft cloud into Microsoft Graph. このようなデータには、たとえば、オンプレミスやパブリック クラウド、またはプライベート クラウドでホストされる組織の人事データベースや製品カタログなどがあります。Examples of such data can be an organization's human resources database or product catalog, hosted on-premises or in the public or private clouds.

Microsoft Graph コネクタは外部データ ソースへの接続を作成して、データのインデックスを作成し、外部のカスタム アイテムとファイルとして保存します。Microsoft Graph connectors create connections to external data sources, index the data, and store it as external custom items and files. インデックスが作成されると、これらのアイテムは Microsoft Search 内と、Microsoft Search API を使用するアプリに表示できます。Once indexed, those items can show up in Microsoft Search, and for apps that use the Microsoft Search API.

Microsoft Graph データ接続を使用して大規模な Microsoft Graph データにアクセスするAccess Microsoft Graph data at scale using Microsoft Graph data connect

Microsoft Graph _データ接続_を使用して、Microsoft Graph 上の大規模なデータにアクセスします。また、管理者は Microsoft Graph データの同意対象の細分化と完全な管理ができます。Use Microsoft Graph data connect to access data on Microsoft Graph at scale, while allowing administrators granular consent and full control over their Microsoft Graph data. データ接続により、このデータの Microsoft Azure への配信が効率化されます。Data connect streamlines the delivery of this data to Microsoft Azure.

Azure ツールを使用すると、次のようなインテリジェント アプリを構築できます。Using Azure tools, you can then build intelligent apps that:

  • 組織内にいる、あなたのトピックに関する専門家で、場所が最も近い人を探すFind you the closest expert on a topic to you in your organization
  • ナレッジ ベース作成を自動化するAutomate knowledge base creation
  • 会議室の使用状況に関する洞察を得るために、会議出席依頼を分析するAnalyze meeting requests to provide insights into conference room utilization
  • 生産性および通信のデータから不正行為を検出するDetect fraud with productivity and communication data

Microsoft Graph API またはデータ接続を使用するタイミングWhen should I use Microsoft Graph API or data connect?

Microsoft Graph データ接続は、Microsoft Graph API を通じて利用可能なデータとやりとりする新たな方法を提供します。Microsoft Graph data connect provides a new way for you to interact with the data that's available through Microsoft Graph APIs. データ接続は、Microsoft クラウド内でインテリジェントなアプリケーションの構築を効率化する独自のツール セットを提供します。Data connect provides a unique set of tools that streamline the building of intelligent applications, all within the Microsoft cloud.

機能Feature Microsoft Graph APIMicrosoft Graph API Microsoft Graph データ接続Microsoft Graph data connect
アクセス スコープAccess scope 1 人のユーザーまたはテナント全体Single user or entire tenant 多数のユーザーまたはグループMany users or groups
アクセス パターンAccess pattern リアルタイムReal time 定期的なスケジュールRecurrent schedule
データ操作Data operations データ マスターに対する操作Operates on data master データのキャッシュに対する操作Operates on a cache of the data
データ保護Data protection データは Microsoft 365 内にある間は保護されるData is protected while in Microsoft 365 データ保護対象は Azure サブスクリプション内のデータのキャッシュにも拡大されるData protection is extended to the cache of data in your Azure subscription
ユーザーの同意User consent 自分Self
リソースの種類Resource types
なしNone
管理者の同意Admin consent 組織全体Entire organization
リソースの種類Resource types
ユーザーのグループを選択Select groups of users
リソースの種類とプロパティResource types and properties
ユーザーを除外Excludes users
アクセス ツールAccess tools RESTful Web クエリRESTful web queries Azure Data FactoryAzure Data Factory

詳細については、「Microsoft Graph データ接続」を参照して、Microsoft Graph データ接続の使用を開始しますSee Microsoft Graph data connect for more information, and get started using Microsoft Graph data connect.

次の手順Next steps