Microsoft Graph 概述

Microsoft Graph通过一个终结点从 Office 365 和其他 Microsoft 云服务公开了多个 API:https://graph.microsoft.com。Microsoft Graph 简化了本来会更加复杂的查询。

可以使用 Microsoft Graph 执行以下操作:

  • 访问多个 Microsoft 云服务中的数据,包括 Azure Active Directory、作为 Office 365 一部分的 Exchange Online、SharePoint、OneDrive、OneNote 和 Planner。
  • 在实体和关系之间导航。
  • 访问 Microsoft 云中的情报和见解(针对商业用户)。

Microsoft Graph 开发堆栈

显示 Microsoft Graph 开发堆栈层的关系图。底部是数据层,包括用户、组、文件、邮件、日历、个人联系人、任务、组织联系人、人员、Excel 和注释。下一层是身份验证和授权。接下来是所选的开发环境,包括 Android,iOS 和 Visual Studio Microsoft Graph API SDK。最后一层是解决方案,它使用包括 .NET、JS、HTML 和 Ruby 在内的所选技术,并且被托管在 Microsoft Azure 或其他托管平台中。

常见的 Microsoft Graph 查询

Microsoft Graph 公开了两个终结点:/v1.0 和 /beta。/V1.0 终结点包括可在生产应用中访问的资源。 /beta 终结点包含当前处于预览状态的 API。下表列出了一些可用于访问 Microsoft Graph API 的常见查询。

操作 服务终结点
获取我的个人资料 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/calendar
获取我的经理 https://graph.microsoft.com/v1.0/me/manager
获取上一个修改文件 foo.txt 的用户 https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser
获取我隶属于的统一组 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/{id}/conversations
获取与我相关的人员 https://graph.microsoft.com/beta/me/people
获取我常用的项目 https://graph.microsoft.com/beta/me/insights/trending
获取我的任务 https://graph.microsoft.com/beta/me/tasks
获取我的注释 https://graph.microsoft.com/beta/me/notes/notebooks

注意:beta 终结点中的 API 可能会发生更改。建议不要在生产应用中使用它们。

浏览 Microsoft Graph

我们非常重视你的反馈。请在 Stack Overflow 上与我们联系。使用 {MicrosoftGraph} 和 {office365} 标记出你的问题。