Microsoft Graph 简单描述

第一次写开发类的文章，手生请见谅。

Microsoft Graph可能不是一个可以顾名思义的功能，它和图像（Graph）可没有什么关系。实际上它是微软推出的一套 REST API 功能，其涉及了多微软云端服务的可调用的 API 接口，包括但不限于 Office 365（对 Exchange Online 邮箱数据的调用，对 SharePoint 和 OneDrive 上文件的调用、对用户建立和分配许可等）、Azure AD 等。

在Microsoft Graph API（下文称 Graph API）出现之前，其实各个服务也大多都有自己的 API，如 Outlook REST API、OneNote REST API、OneDrive REST API 等等，但每个 API 的接入点都不同，对应的服务主体也不同，导致用户和开发者在进行调用的时候，往往需要申请多个 Token（令牌）去调用。而 Graph API 总结并合并了以上这些API，并逐步摒弃了一些需要通过 SDK或单独安装才能使用的开发模块。（如EWS或SCOM，当然开发人员仍然可以继续使用这些开发模块，但随着微软的一些官方声明的表示，这些模块将逐步被淘汰或停止更新）

在调用上，Graph API 使用了统一的接入点进行调用（国际版为 https://graph.microsoft.com、中国版为 https://microsoftgraph.chinacloudapi.cn）并可一次性设置需要调用的所有API权限（如既访问日历上的事件、又读取OneDrive中的文件这样的需求）；同时，还可在一个服务主体的情况下，为不同平台上的服务（如 Web，Android、iOS 手机应用，桌面应用等）设置不同的重定向指向，以满足跨平台的需求。

当然，很多知识还是要从REST API的一般调用方法与认证方式讲起，Graph API毕竟是一种 API，通过它进行开发，并不像Power Apps或 Power Automate那样的微软产品简单易上手，但借助于各种开发语言，它的能力是极为强大的。我将在以后的文章中陆续说明一些基础知识。但就开发而言，学习一种API还是要有一些最基本比本的知识的，如基本的网络知识、OAuth 认证的一些基础知识、Http 方法等等。

我查阅过一些文档，发现很多文档对中国版的 Office 365 并不友好，往往缺乏对中国版 Office 365 上 Graph API 调用的说明。虽然很多 API 接口在中国版环境中还是可用的，但由于开发人员缺乏必要的了解，也使得在中国这个大环境下的许多开发者无从下手。因此我决定以中国版 Office 365 作为文中的举例，以弥补中国版 Graph API 文档确实造成不足。另外，围绕微软系的产品，一些涉及到代码的示例，将以 C# .Net 作为开发语言。

那么 Graph API 的开发，最源头从何处说起呢，我想应该是从获取认证开始讲起。也就是在 Azure AD 上注册应用，并通过这个应用开始对 API 接口的一系列调用。那么下一篇文章中，我将详细描述如何获取认证凭据，也就是认证的相关内容（准备工作）。敬请期待，谢谢大家。