Movatterモバイル変換


[0]ホーム

URL:


Skip to main content

This browser is no longer supported.

Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.

Download Microsoft EdgeMore info about Internet Explorer and Microsoft Edge
Table of contentsExit editor mode

Overview of Microsoft Graph

Feedback

In this article

Microsoft Graph is the gateway to data and intelligence in Microsoft cloud services like Microsoft Entra and Microsoft 365. Use the wealth of data accessible through Microsoft Graph to build apps for organizations and consumers that interact with millions of users.

Microsoft Graph, Microsoft Graph Data Connect, and Copilot connectors enable extending Microsoft 365 experiences and building intelligent apps.

Data and services powering the Microsoft 365 platform

In the Microsoft 365 platform, three main components facilitate the access and flow of data:

  • TheMicrosoft Graph API offers a single endpoint,https://graph.microsoft.com, to provide access to rich, people-centric data and insights in the Microsoft cloud, including Microsoft 365, Windows, and Enterprise Mobility + Security. You can use REST APIs or SDKs to access the endpoint and build apps that support Microsoft 365 scenarios, spanning across productivity, collaboration, education, people and workplace intelligence, and more. Microsoft Graph also includes a powerful set of services that manage user and device identity, access, compliance, and security and help protect organizations from data leakage or loss.
  • Microsoft 365 Copilot connectors (formerly Microsoft Graph connectors) 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. Connectors exist for many commonly used data sources such as Box, Google Drive, Jira, and Salesforce.
  • Microsoft Graph Data Connect provides a set of tools to streamline secure and scalable delivery of Microsoft Graph data to popular Azure data stores. The cached data serves as data sources for Azure development tools that you can use to build intelligent applications.

Together, the Microsoft Graph API, connectors, and Data Connect power the Microsoft 365 platform. With the ability to access Microsoft Graph data and other datasets, you can derive insights and analytics, extend Microsoft 365 experiences, and build unique, intelligent applications.

What's in Microsoft Graph?

Microsoft Graph exposes REST APIs and client libraries to access data on the following Microsoft cloud services:

  • Microsoft 365 core services: Bookings, Calendar, Excel, Microsoft Purview eDiscovery, Microsoft Search, OneDrive, OneNote, Outlook/Exchange, People (Outlook contacts), Planner, SharePoint, Teams, To Do, Viva Insights
  • Enterprise Mobility + Security services: Advanced Threat Analytics, Advanced Threat Protection, Microsoft Entra, Identity Manager, and Intune
  • Windows services: activities, devices, notifications, Universal Print
  • Dynamics 365 Business Central services
  • Microsoft Partner Center services

To find out more, seeMajor services and features in Microsoft Graph.

An image showing the primary resources and relationships that are part of Microsoft Graph

What can you do with 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.
  • 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.
  • 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.
  • Analyzes at-scale Microsoft 365 data so that decision makers can unlock valuable insights into time allocation and collaboration patterns that improve business productivity.
  • 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. With the Microsoft Graph API, you can:

  1. Get the email addresses of themeeting event attendees.
  2. Look them up individually as auser in Microsoft Entra ID toget their profile information.

You can then navigate to other resources using relationships:

To find out more, seeIntegration patterns.

Microsoft Graph is secured and only authorized callers can access the data. For more information, seeAuthentication and authorization.

Note

When you use Microsoft Graph APIs, you agree to theMicrosoft APIs Terms of Use and theMicrosoft Privacy Statement.

Popular API requests

Check out some of these common scenarios for working with the Microsoft Graph API. The links take you to theGraph Explorer.

OperationURL
GET my profilehttps://graph.microsoft.com/v1.0/me
GET my fileshttps://graph.microsoft.com/v1.0/me/drive/root/children
GET my photohttps://graph.microsoft.com/v1.0/me/photo/$value
GET my mailhttps://graph.microsoft.com/v1.0/me/messages
GET my high importance emailhttps://graph.microsoft.com/v1.0/me/messages?$filter=importance%20eq%20'high'
GET my calendar eventshttps://graph.microsoft.com/v1.0/me/events
GET my managerhttps://graph.microsoft.com/v1.0/me/manager
GET last user to modify file foo.txthttps://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser
GET Microsoft 365 groups I'm a member ofhttps://graph.microsoft.com/v1.0/me/memberOf/$/microsoft.graph.group?$filter=groupTypes/any(a:a%20eq%20'unified')
GET users in my organizationhttps://graph.microsoft.com/v1.0/users
GET groups in my organizationhttps://graph.microsoft.com/v1.0/groups
GET people related to mehttps://graph.microsoft.com/v1.0/me/people
GET items trending around mehttps://graph.microsoft.com/beta/me/insights/trending
GET my noteshttps://graph.microsoft.com/v1.0/me/onenote/notebooks

Bring data from an external content source to Microsoft Graph

UseCopilot 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.

Copilot connectors create connections to external data sources, index the data, and store it as external custom items and files. Once indexed, those items can show up in Microsoft Search and for apps that use theMicrosoft Search API.

Access Microsoft Graph data at scale

UseMicrosoft Graph Data Connect to access data on Microsoft Graph at scale, while allowing administrators granular consent and full control over their Microsoft Graph data. Data Connect streamlines the delivery of this data to Microsoft Azure.

Using Azure tools, you can then build intelligent apps that:

  • Find you the closest expert on a subject area 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.

When should I use Microsoft Graph API or Data Connect?

Microsoft Graph Data Connect provides a new way for you to interact with the data that's available through Microsoft Graph APIs. Data Connect provides a unique set of tools that streamline the building of intelligent applications, all within the Microsoft cloud.

FeatureMicrosoft Graph APIMicrosoft Graph Data Connect
Access scopeSingle user or entire tenantMany users or groups
Access patternReal timeRecurrent schedule
Data operationsOperates on data masterOperates on a cache of the data
Data protectionData is protected while in the source service like Microsoft 365 and Microsoft EntraData protection is extended to the cache of data in your Azure subscription
User consentSelf
Resource types
None
Admin consentEntire organization
Resource types
Select groups of users
Resource types and properties
Excludes users
Access toolsRESTful web queriesAzure Data Factory

Related content


Feedback

Was this page helpful?

YesNoNo

Need help with this topic?

Want to try using Ask Learn to clarify or guide you through this topic?

Suggest a fix?

  • Last updated on

In this article

Was this page helpful?

YesNo
NoNeed help with this topic?

Want to try using Ask Learn to clarify or guide you through this topic?

Suggest a fix?