用途:该技能用于接入 Office 365 Outlook,让应用能够访问邮件与日历能力,集成 Outlook 相关功能。它是一个轻量包装,本身不单独实现逻辑,而是委托给 /add-data-source 完成接入。
使用方式:调用 /add-data-source,并设置 api-id 为 shared_office365,mode 为 action。接入完成后即可使用 Office365OutlookService,其中包含 20 多个方法。
主要能力:日历方面,可用 CalendarGetTables 发现日历 ID;用 GetEventsCalendarViewV2 按日期范围查询事件(参数含 calendarId、ISO 8601 格式的 startDateTimeOffset 与 endDateTimeOffset,以及可选的 top、skip 分页);用 OnUpcomingEventsV3 查询临近事件(table 与 minutesWindow);用 V3CalendarPostItem 创建事件;用 CalendarPatchItem 更新事件;用 CalendarDeleteItem 删除事件。邮件方面,可用 SendEmailV2 发送邮件,用 GetEmails 获取收件箱(支持 folderPath、fetchOnlyUnread、top),用 GetEmail 读取单封邮件,用 MarkAsRead 标记已读,用 ReplyToV3 回复邮件。
限制与注意事项:文档强调必须先通过 CalendarGetTables() 发现真实日历 ID,不应硬编码 "Calendar",否则用户主日历名称不同时会失败;日期参数应使用 .toISOString() 生成的 ISO 字符串;需校验响应成功与数据非空后再继续。关于收费、平台支持范围、版本要求等事实,资料暂未提供。