1、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接口的一系列调用。那么下一篇文章中，我将详细描述如何获取认证凭据，也就是认证的相关内容（准备工作）。敬请期待，谢谢大家。