Microsoft 365系列01:了解MS365接口API-基本介绍和如何使用

Microsoft Graph Explorer 是 Microsoft 提供的基于 Web 的工具,允许开发人员和管理员探索 Microsoft Graph API 并与之交互。Microsoft Graph API 是一个统一的终结点,用于访问 Microsoft 365 中的数据和服务,包括来自 Outlook、SharePoint、OneDrive、Teams 等服务的资源。也就是说,并不是需要通过网页或者app才能访问您保存在MS365云端的数据,通过Microsoft提供的这些API也是可以的。

如果您只想续订您的 MS365 开发人员订阅,我想您可以尝试时不时地随机进行几次 Microsoft Graph API 调用。

这意味着您可以使用 Microsoft Graph Explorer 获取保存在 MS365 云中的信息,包括但不限于 OneDrive for Business、Outlook 电子邮件、Word 文档等。

跟着我来了解一下吧!

如何使用 Microsoft Graph 浏览器

  1. 访问工具:转到 Microsoft Graph 浏览器 网站: Graph Explorer | Try Microsoft Graph APIs - Microsoft Graph
  2. 登录:使用具有访问您感兴趣的资源所需的权限的 Microsoft 帐户登录(工作或企业帐户,您可以注册 Microsoft 365 开发人员订阅以获取工作或企业帐户)。
  3. 选择 API 调用:从示例查询列表中进行选择,或在请求生成器中输入自定义 API 终端节点 URL。

这里的截图是查询 me 信息:

响应如下:

响应回来的值,它是一种 JSON 格式,具有结构性,就像字典一样。JSON 被广泛使用,因为它非常易于理解且易于访问其内部信息。

使用此响应 JSON 数据,您可以使用工具获取里面包含的信息。比如,用 Python 获取 JSON 内部信息:Response[‘givenName’],您将获得数据值 “Nathan”。

HTTP 是万维网的基本协议,用于在浏览器和服务器之间传输数据。你一定熟悉上网:在网页浏览器中输入类似 “www.baidu.com” 的 URL,然后按 “Enter”,就会看到百度首页。
你有没有想过后台发生了什么?
实际上,在你点击 “Enter” 按钮后,Web 浏览器会帮助你使用 HTTP 协议的 GET 方法 ,当它从百度服务器收到响应时,浏览器会将响应解释为人类可读的网页并呈现给你。
除了 GET,还有一些其他方法,例如 POST,用于向服务器提交一些信息,例如您的用户名和密码。

以下是一些常见 HTTP 方法的简要概述:

  • GET:该方法用于向指定资源请求数据。它只应用于获取数据,而不应用于更改服务器状态。

  • POST:POST 用于向服务器发送数据以创建/更新资源。它通常在提交表单或创建新记录时使用。

  • DELETE:顾名思义,该方法用于删除指定的资源。它是幂等的,这意味着调用它一次或多次将具有相同的效果。

  • PATCH:PATCH 用于更新资源的某些部分。与可能意味着完全替换的 POST 不同,PATCH 表示部分更新。

  • PUT:PUT 用于使用提供的数据更新指定的资源。如果尚不存在,它还可用于创建新资源。与 POST 不同,PUT 请求是幂等的。

这些方法是 HTTP 标准的一部分,用于 RESTful Web 服务,其中资源使用这些定义的操作进行操作。每个请求都有自己的用例和语义,并且它们被设计为无状态的,这意味着每个请求都包含理解和处理请求所需的所有信息,而无需在服务器端存储上下文。

因此,如果您想从 MS365 云中提取数据,我认为在大多数情况下,您可以只使用 GET 方法。

有时,某些 API 可能需要一些特殊权限,那么你只需要“修改权限”,以便 Microsoft Graph Explorere 可以访问该相关信息。

您还可以转到 Microsoft Graph API 参考 ( https://learn.microsoft.com/en-US/graph/api/overview) 了解更多详细信息。它将包含每个 API 的大量详细信息,包括所需的权限。

简单推荐两个 API:

  • OneDrive - 列出驱动器中的项目
  • OneNote – 我的笔记本

你可以在这里尝试很多不同的API,我想这些调用应该也会算作是开发工作(development activities),也许对续期 MS365 E5 有一定的帮助…

总结:

Microsoft Graph Explorer 对于使用 Microsoft Graph 的任何人来说都是一个有价值的工具,尤其是那些需要快速测试不同方案或解决与 API 交互相关的问题的用户。

使用 Microsoft Graph 浏览器的好处

  • 效率:无需编写代码即可快速测试和调试 API 调用。
  • 学习工具:非常适合了解 Microsoft Graph API 的功能。
  • 开发辅助:帮助开发与 Microsoft 365 服务集成的应用程序。
  • 文档:提供对 API 文档和示例的轻松访问

希望本文可以帮助您更好地了解 Microsoft 365 以及云在所有这些中的作用。由于所有数据都存储在云中,因此可以通过统一的接入点获取这些信息。

实际上,Microsoft Graph Explorer 只是一个微软官方提供的应用程序,可以在您允许的情况下访问您的数据。将来,我将向您展示如何创建自己的应用程序来访问存储在 Microsoft 365 中的数据,您还可以在应用程序中使用自己的应用程序,例如 Python 应用程序。

9 个赞

感谢你的教程

一大清早就mark

支持分享,谢谢

1 个赞

谢谢支持,您的支持是我分享的动力~

哈哈,谢谢!!

1 个赞

谢谢反馈,感谢支持!!!

感谢大佬的分享

回忆起了最开始对接 这个鬼东西的痛苦。还是用java对着写

感谢分享 :smiling_face_with_three_hearts: :smiling_face_with_three_hearts:

1 个赞