Microsoft Graph请求语法Microsoft Graph请求语法

本篇我们对Microsoft Graph的请求语法进行一下分析。

语法

https://graph.microsoft.com/{version}/{resource}/{id}/{property}?{query-parameters}

HTTP动词

Microsoft Graph接受以下HTTP请求动词以确定要执行的操作：

GET - 从资源读取数据

POST - 创建新的资源或执行一个操作

PATCH - 用新值更新资源

PUT - 用新的资源替换已存在的

DELETE - 删除资源

版本

Microsoft Graph当前支持以下两个版本：

v1.0 - 用于生产环境应用程序的常规可用API。

beta - 可以理解为抢鲜版，里面包含了一些预览版的API，但是可能会包含破环性的更新，因此推荐用于开发或测试目的。

通过对比我们可以发现beta版本的API的一些特定端点包含额外的属性和格式，或一些来自于v1.0的等效变化。

对于Graph做了哪些具体的更新，我们可以通过此页面查看。

资源

顶级的端点，指定我们的请求要跟哪个服务进行交互。包含但不限于以下这些：

Users

Groups

Sites

Drives

Me

Devices

很多资源相互之间都是有联系的，这使得横向访问Graph变得容易。例如，/me/drive，/users/{id}/events等。

Id (可选项)

指定集合中的成员如一个独立的用户、组、网站等。

属性 (可选项)

指定父资源的某个属性。

查询参数 (可选项)

修改请求的响应来过滤结果，包含或排除属性、对结果进行排序等。