Microsoft Graph 快速入门 FAQ

此 FAQ 解答了与 Microsoft Graph 快速启动相关的问题。

常规设计

快速启动示例展示了如何使用 Microsoft Graph。 在这些示例中,只需通过一次身份验证即可访问两项服务:Microsoft 帐户和 Outlook。 每个快速启动均均会访问 Microsoft 帐户用户个人资料中的信息,并显示其日历中的事件。

快速启动分为四步:

  • 选择平台
  • 获取应用 ID(客户端 ID)
  • 生成示例
  • 登录,然后查看日历上的事件

完成快速启动后,即表示应用程序可供运行。

先决条件

所有快速启动示例都需要访问在 Outlook.com 上拥有邮箱的个人 Microsoft 帐户,或具有 Exchange Online 邮箱的 Microsoft 工作或学校帐户。 如果你没有 Microsoft 帐户,则有几个选项可以获取免费帐户:

快速启动示例常见问题

不通过快速启动页面下载可以获取快速启动代码吗?

当然可以! 每个快速启动下载都是基于 Microsoft Graph 教程,因此,可以通过其他两种方法获取相同的源代码:

  • 按分步教程操作,自己构建代码。
  • 从相应的 GitHub 存储库下载完整的项目,然后按照自述文件中的说明配置和运行示例。

教程和 GitHub 存储库

下表列出了每个快速启动示例对应的教程和 GitHub 存储库。

快速启动 教程 GitHub 存储库
Android 教程 GitHub
Angular 教程 GitHub
ASP.NET MVC 教程 GitHub
iOS Swift 教程 GitHub
iOS Objective-C 教程 GitHub
Node.js 教程 GitHub
PHP 教程 GitHub
Python 教程 GitHub
React 教程 GitHub
Ruby 教程 GitHub
UWP 教程 GitHub
Xamarin 教程 GitHub

为什么所有快速启动示例都没有展示高级身份验证用例?

通过快速启动示例,大家认识了身份验证和 Microsoft Graph API 调用。 可以在 Azure Active Directory 文档中了解与其他身份验证流相关的更多信息。

使用快速启动时发生意外错误或遇到问题,该怎么办?

如果无法正常使用快速启动,请在对应的 GitHub 存储库中报告问题。

已知问题

ASP.NET 快速启动在运行时显示错误:找不到部分路径“[...]\Graph Tutorial\graph-tutorial\bin\roslyn\csc.exe”。

这是由 Visual Studio 和 Roslyn 编译器的问题引起的。 以下选项之一应该可解决该错误。

  • 在解决方案资源管理器中卸载/重新加载项目
  • 清理/重新构建解决方案
  • 升级 NuGet 包

运行快速启动时,我遇到错误“AADSTS50011:请求中指定的回复 URL 与为应用程序配置的回复 URL 不匹配”。

这表示快速启动的应用程序注册存在问题。 从 Microsoft Graph 快速入门页面下载快速启动时,我们会为你创建应用程序注册,并配置与示例项目使用的默认 URL 匹配的回复 URL(也称为重定向 URL)。 如果你更改了此 URL,则应用程序注册将不再匹配,并可能导致此错误。 若要解决此错误,请参阅快速启动项目附带的 README.md 文件,以获取有关如何创建应用程序注册并在示例代码中对其进行配置的说明。

登录后,告诉我需要管理员批准。

登录快速启动示例之一后,你可能会看到一条消息,显示需要管理员批准"XXX 教程需要访问组织中只有管理员可以授予的资源的权限。 Please ask an admin to grant permission to this app before you can use it." 这不是示例的 Bug! 任何快速启动请求都不Graph需要管理员同意 的任何权限 范围。 租户管理员可以禁用你同意Graph他们尚未批准的任何应用的权限范围。 在这种情况下,你将看到此错误。

你需要与管理员一起审批、使用个人 Microsoft 帐户 (Outlook.com) 或使用具有 Exchange Online 的测试 Microsoft 365 租户。

找不到需要的内容?

如果此 FAQ 无法解答在使用一个或多个快速启动时遇到的问题,请使用下面的“反馈”部分告知我们。