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

发布了5 篇原创文章 · 获赞 13 · 访问量 1048

猜你喜欢

转载自blog.csdn.net/isaac618/article/details/105217813
今日推荐