Graph 浏览器 是一种开发人员工具,便于发起 Microsoft Graph REST API 请求并查看相应响应。 本文介绍了如何使用 Graph 浏览器中的一些重要功能。
有关概述,请参阅使用 Graph 浏览器试用 Microsoft Graph API。
同意权限
用户或管理员必须通过同意流程向 Graph 浏览器授予正确权限,从而访问 Microsoft Graph 中的数据。 登录后,通过“修改权限”选项卡或配置文件旁边的设置齿轮中的“选择权限”选项同意 Graph 浏览器中的权限。 “修改权限”选项卡列出了在地址栏中运行查询所需的所有权限。
要同意权限:
- 选择并运行示例查询。
- 选择“修改权限”选项卡。
- 查看运行查询所需的权限列表。
- 选择要同意的权限旁边的“同意”按钮。
突出显示了同意权限步骤的 Graph 浏览器屏幕截图
“修改权限”功能当前处于预览状态,一些查询可能缺少权限。 如果查询缺少权限,则配置文件旁边的设置齿轮中的“选择权限”选项包含所有可用权限的列表:
- 转到设置齿轮并选中“选择权限”选项。 此选项包含所有可用权限的列表。
- 从所有权限列表中,同意所需权限。
突出显示了“选择权限”选项的 Graph 浏览器屏幕截图
获取访问令牌或身份验证令牌
Graph 浏览器包含“访问令牌”选项卡,该选项卡会在登录后显示访问令牌。 在“访问令牌”选项卡上,如果需要在最喜爱的 REST 客户端应用程序中使用该令牌,则可以进行复制。
Graph 浏览器中“访问令牌”选项卡的屏幕截图,其中突出显示了“复制”按钮
复制代码片段
对于在 Graph 浏览器中选择或输入的每个 REST API 查询,可以找到如何用“代码片段”选项卡下展示的四种语言 - C#、Java、JavaScript 和 Objective-C 中的每一种调用该 API。
突出显示了“代码片段”选项卡的 Graph 浏览器屏幕截图
集成 UI 组件
Graph 浏览器包含多个功能,以简化 UI 的实现。 也可以在应用中重复使用这些组件。
Microsoft Graph 工具包集成
Microsoft Graph 工具包 集合了可重用的、与框架无关的 Web 组件和帮助程序,用于访问和使用Microsoft Graph。 这些组件功能齐全,其内置提供程序使用 Microsoft Graph 进行身份验证并从中提取数据。
Graph 浏览器提供与 Microsoft Graph 工具包组件对应的示例 REST API 查询。 “工具包组件”选项卡上的蓝点指示工具包为 Graph 浏览器中当前指定的 REST API 查询提供组件。 可以轻松地将组件代码复制到应用。
下表列出了当前包含工具包组件的示例查询。
| Graph 浏览器示例查询 | 工具包示例 iFrame URL |
|---|---|
| 获取我的个人资料 | https://mgt.dev/iframe.html?id=components-mgt-person-card—个人卡悬停 |
| 获取我的合作人员 | https://mgt.dev/iframe.html?id=components-mgt-people—人员 |
| 获取我的所有规划器任务 | https://mgt.dev/iframe.html?id=components-mgt-tasks—任务 |
| 获取我下周的活动 | https://mgt.dev/iframe.html?id=components-mgt-agenda—获取下周活动 |
| 获取我的照片 | https://mgt.dev/iframe.html?id=components-mgt-person—仅个人照片 |
“工具包组件”选项卡的屏幕截图,其中突出显示了用于生成组件的代码
自适应卡片集成
“自适应卡片”是以 JSON 编写的与平台无关的 UI 片段,应用和服务可以公开交换这些片段。 当运行查询且自适应卡片可用时,“自适应卡片”选项卡上会显示蓝点。
Graph 浏览器中“自适应卡片”选项卡的屏幕截图,其中突出显示了响应详细信息
在 Graph 浏览器中自定义主题
选择设置齿轮下的“更改主题”选项,以选择 Graph 浏览器的主题。 主题选项 浅色、 深色 和 高对比度。
Graph 浏览器中“更改主题”选项的屏幕截图,其中突出显示了主题选项
存储和共享查询
在 Graph 浏览器中运行的查询会在“历史记录”选项卡中保存 30 天。在“历史记录”选项卡上,可以:
- 以
.har格式导出所有历史记录项。 - 删除所有历史记录项。
- 查看历史记录项。
- 运行查询。
- 以
.har格式导出历史记录项。 - 删除历史记录项。
突出显示了选项的“历史记录”选项卡屏幕截图
若要共享运行的查询,请在响应窗格中选择“共享 ”按钮,然后选择“复制”。 此操作会复制链接,以共享并允许他人查看你的查询和结果。
突出显示了“共享和复制”选项的 Graph 浏览器屏幕截图
Graph 浏览器 UI 功能
若要扩大请求和响应区域,请在 Graph 资源管理器中折叠和展开边栏组件。 要折叠边栏组件,请选择边栏左上角的汉堡图标。
突出显示了“展开并折叠”选项的 Graph 浏览器屏幕截图
在响应预览窗口中选择“展开”箭头,以展开并折叠响应预览。
突出显示了“展开并折叠”选项的响应窗格屏幕截图
从 Graph 浏览器 UI 轻松访问 Microsoft 365 开发人员计划网站,从而免费获取包含要试验的示例数据的沙盒。在设置齿轮下,选择 获取包含示例数据的沙盒。
突出显示了“获取包含示例数据的沙盒”选项的 Graph 浏览器屏幕截图
后续步骤
- 访问 Graph 浏览器 并浏览示例查询。
- 浏览 Microsoft Graph 工具包文档。
- 在 Graph 浏览器 GitHub 存储库 中贡献或提供反馈。
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 RabebOthmani)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
