使用 Microsoft Outlook Graph 获取事件日期 - TypeScript

Microsoft Outlook Graph API 提供了一个简单的方式来获取 Outlook 日历中的事件信息。使用 TypeScript 可以使代码变得更加清晰和易于维护。

步骤

1. 创建应用程序

首先需要创建一个应用程序，并授予该应用程序对 Office 365 Graph API 的访问权限。可以使用 Azure Portal 来完成该操作。

2. 安装 @microsoft/microsoft-graph-types 包

使用以下命令在 TypeScript 项目中安装 @microsoft/microsoft-graph-types 包：

npm install @microsoft/microsoft-graph-types --save-dev

该包为 Outlook Graph API 提供了完整的类型定义，可以使代码编写更加准确。

3. 导入 Microsoft Graph 类型

在 TypeScript 代码中，导入 Microsoft Graph 类型的一个简单方法是使用以下语句：

import * as MicrosoftGraph from "@microsoft/microsoft-graph-types";

4. 获取事件列表

下一步是获取 Outlook 日历中的事件列表。可以使用以下代码进行此操作：

async function getEvents(accessToken: string): Promise<MicrosoftGraph.Event[]> {
  const response = await fetch("https://graph.microsoft.com/v1.0/me/events", {
    method: "GET",
    headers: {
      Authorization: `Bearer ${accessToken}`,
    },
  });

  const result = await response.json();
  return result.value;
}

该代码调用 /me/events 端点并返回事件数组。

5. 获取事件日期

最后一步是获取特定事件的日期。可以使用以下代码进行此操作：

async function getEventStartDate(accessToken: string, eventId: string): Promise<Date> {
  const response = await fetch(`https://graph.microsoft.com/v1.0/me/events/${eventId}`, {
    method: "GET",
    headers: {
      Authorization: `Bearer ${accessToken}`,
    },
  });

  const result = await response.json();
  return new Date(result.start.dateTime);
}

该代码将 eventId 作为参数并调用 /me/events/{eventId} 端点。然后，使用 response.start.dateTime 属性返回事件开始日期时间。

结论

上述代码片段演示了如何使用 TypeScript 和 Microsoft Outlook Graph API 来获取 Outlook 日历中的事件日期。该过程涉及创建应用程序、安装必需的包、导入 Microsoft Graph 类型、获取事件列表以及获取特定事件的日期。