如何使用Graph API创建带频道详情的Microsoft Teams频道日历事件？

可以通过Microsoft Graph API在Teams频道日历中创建事件，具体实现步骤如下：

一、获取频道日历的必要ID #

要定位到目标频道的日历，需要先获取三个核心ID：

• 团队ID：如果已知团队名称（如"ABC"），调用GET /groups?$filter=displayName eq 'ABC'，从返回结果中提取团队的id（Teams团队本质是Microsoft 365组）。
• 频道ID：调用GET /teams/{team-id}/channels，找到名称为"General Channel"的频道，提取其id。
• 频道日历ID：调用GET /teams/{team-id}/channels/{channel-id}/calendar，返回结果中的id就是该频道日历的文件夹ID。

二、创建频道日历事件 #

拿到频道日历ID后，使用以下API创建事件：
POST /groups/{team-id}/calendar/calendars/{channel-calendar-id}/events

请求体示例 #

{
  "subject": "团队同步会议",
  "body": {
    "contentType": "HTML",
    "content": "<p>这是在General频道日历创建的测试会议</p>"
  },
  "start": {
    "dateTime": "2024-06-15T14:00:00",
    "timeZone": "UTC"
  },
  "end": {
    "dateTime": "2024-06-15T15:00:00",
    "timeZone": "UTC"
  },
  "attendees": [
    {
      "emailAddress": {
        "address": "user1@contoso.com",
        "name": "张三"
      },
      "type": "required"
    }
  ]
}

三、权限要求 #

调用上述API需要配置对应的权限：

• 应用权限：Group.ReadWrite.All（需管理员同意）
• 委派权限：Group.ReadWrite.All 或 Calendars.ReadWrite

四、关键说明 #

目前无法直接通过"ABC>General Channel"这类字符串直接调用API创建事件，必须先解析出团队ID、频道ID，再获取频道日历ID后执行创建操作。

内容的提问来源于stack exchange，提问作者Sigar Dave