outlook-restapi - Outlook REST API与Microsoft Graph

Question

我正在开发一个需要从Outlook.com和Office 365检索和编辑日历事件的应用程序。我已经看到有2个选项:

Outlook REST API

Microsoft Graph

它们似乎具有几乎相同的界面。我看到Outlook REST API支持通知(webhooks)，Microsoft graph不支持吗？那么，选择哪一个呢？优点/缺点是什么？为什么有两个API？

Answer 1

要从Outlook.com检索和编辑日历事件，可以使用Microsoft Graph API和Outlook REST API端点。如果需要计划在生产中使用的应用程序需要Webhooks，则需要使用Outlook REST API v2.0终结点。我们已经在Microsoft Graph的预览版中提供了Webhooks，并且正在对其进行GA处理，因此您将来可以在生产应用程序中使用它们。如果您的应用程序不需要Webhooks，则可以使用Microsoft Graph v1.0。完全支持Microsoft Graph和Outlook REST API端点。

现在继续说明为什么有2个端点。 Outlook REST API v1.0于2014年10月启动，我们在2015年11月提供了改进的v2.0版本。它具有通过API公开的最新最强大的Outlook功能。 Microsoft Graph v1.0是我们在2015年11月推出的便捷端点，该应用程序可以从多个Microsoft服务访问信息，例如Outlook，One Drive和Azure Active Directory。实际上，当您向Microsoft Graph v1.0端点提出任何Outlook功能的请求时，该请求将被路由到幕后的Outlook REST API v2.0端点。因此，API集在设计上是相同的!

我们正在努力缩小各个服务API端点(Outlook REST API，OneDrive API，AAD Graph API等)与Microsoft Graph之间的任何差距，但是由于两个原因，会有较小的差异。

各个服务可能具有名称相同但含义不同的实体。例如，Outlook和OneDrive都具有“文件夹”，但是它们的含义不同。在这种情况下，我们需要合理化Microsoft Graph API架构，以使您清楚通过Microsoft Graph API时正在访问哪个实体。文件夹在Outlook API v1.0终结点中可用，我们在Outlook API v2.0终结点中将其重命名为MailFolder，并且该文件夹也通过Microsoft Graph API v1.0公开。因此，在通过Microsoft Graph公开相同功能或API之前，您可能总是会看到一段时间在单个服务终结点中公开某些功能或API。

某些水平功能，例如，Webhooks在Microsoft Graph中可用之前，可以在服务端点中的Preview或GA中更早使用。这是由于Microsoft Graph API是与各个服务端点相比较新的端点。随着时间的流逝，这一差距 list 有望降为零。

我们建议您使用Microsoft Graph，只要它具有生产中支持生产应用程序所需的功能/ API，或者至少具有在Preview中支持应用程序开发所需的功能/ API。这样一来，您将来便可以轻松扩展需要访问多个Microsoft服务的应用程序功能，而无需更改端点。如果需要仅在单个服务端点中可用的功能(在生产(v2.0)中或作为预览版(beta))，则可以使用Outlook REST API等单个服务端点。