关于Graph API订阅与singleValueExtendedProperties及日历事件防删的技术问询

当然可以！Microsoft Graph的变更通知（Change Notifications）订阅功能完全能和singleValueExtendedProperties搭配使用，不管是用来筛选要监控的事件，还是在通知里直接获取扩展属性内容都没问题。

举个实用的例子：如果你只想订阅你的应用创建的特定事件，创建订阅时可以通过$filter指定扩展属性条件，请求示例如下：

POST /subscriptions
Content-Type: application/json

{
  "changeType": "created,updated,deleted",
  "notificationUrl": "https://your-app.com/notifications",
  "resource": "/me/events?$filter=singleValueExtendedProperties/any(ep: ep/id eq 'String {f19d3c30-0660-4f7f...} Name EventSource' and ep/value eq 'YourAppSource')",
  "expirationDateTime": "2024-12-31T00:00:00Z",
  "clientState": "your-secret-client-state"
}

要是想在通知 payload 里直接拿到扩展属性的值，只需在resource里加上$select，比如/me/events?$select=id,subject,singleValueExtendedProperties&$filter=...，这样通知返回的内容就会包含你需要的扩展属性字段了。

针对你提到的三类会议管理需求，尤其是案件事件的防删除要求，我整理了一套落地性强的实现方案：

核心思路 #

用变更通知监控日历事件的删除操作，通过singleValueExtendedProperties标记事件类型和来源，再结合应用权限与后台拦截逻辑，阻止案件事件的非法删除，同时完成三类会议的同步。

步骤1：给事件标记类型与来源 #

你的Java应用在创建会议时，给每个事件添加两个扩展属性：

• 一个标记事件类型：id: String {f19d3c30-0660-4f7f...} Name EventType，值分别设为CaseHearing（案件庭审）、CompanyMeeting（公司会议）、PersonalMeeting（个人会议）
• 另一个标记来源：就是你提到的EventSource属性，值固定为你的应用标识

Java代码示例（用Microsoft Graph SDK）：

Event event = new Event();
event.setSubject("XX案件2024年庭审安排");
// 设置会议时间、参与者、地点等基础属性

// 添加事件类型扩展属性
SingleValueLegacyExtendedProperty eventTypeProp = new SingleValueLegacyExtendedProperty();
eventTypeProp.setId("String {f19d3c30-0660-4f7f...} Name EventType");
eventTypeProp.setValue("CaseHearing");

// 添加来源标记扩展属性
SingleValueLegacyExtendedProperty sourceProp = new SingleValueLegacyExtendedProperty();
sourceProp.setId("String {f19d3c30-0660-4f7f...} Name EventSource");
sourceProp.setValue("YourAppSource");

event.setSingleValueExtendedProperties(Arrays.asList(eventTypeProp, sourceProp));

// 调用Graph API创建事件
graphClient.me().events().post(event);

步骤2：创建案件事件的删除订阅 #

专门创建一个针对案件事件删除操作的订阅，确保只有你的应用创建的案件事件被监控：

POST /subscriptions
Content-Type: application/json

{
  "changeType": "deleted",
  "notificationUrl": "https://your-app.com/calendar-delete-alerts",
  "resource": "/me/events?$filter=singleValueExtendedProperties/any(ep: ep/id eq 'String {f19d3c30-0660-4f7f...} Name EventSource' and ep/value eq 'YourAppSource') and singleValueExtendedProperties/any(ep: ep/id eq 'String {f19d3c30-0660-4f7f...} Name EventType' and ep/value eq 'CaseHearing')",
  "expirationDateTime": "2024-12-31T00:00:00Z",
  "clientState": "your-unique-secret",
  "includeResourceData": true
}

开启includeResourceData后，通知会直接返回事件的完整信息（包括扩展属性），不用再额外调用API查询，节省资源。

步骤3：拦截并恢复案件事件 #

当你的应用收到删除通知时，按以下流程处理：

1. 验证通知合法性：检查clientState是否匹配，以及通知的签名是否有效，防止恶意请求
2. 确认事件属性：从通知内容里确认事件类型是CaseHearing且来源是你的应用
3. 恢复事件：建议提前在本地数据库备份所有案件事件的完整信息，收到删除通知后，直接调用Graph API重新创建该事件（用备份的属性和扩展属性）；也可以尝试用Graph的回收站恢复，但回收站有保留时间限制，本地备份更可靠
4. （可选）提醒用户：给触发删除操作的用户发送邮件或系统消息，说明案件事件不允许删除

步骤4：同步其他类型会议 #

对于公司会议和个人会议，不需要阻止删除，但可以创建通用订阅监控它们的创建、更新、删除操作：

• 订阅的changeType设为created,updated,deleted，$filter只保留EventSource的条件即可
• 收到通知后，根据操作类型（创建/更新/删除）同步到你的应用数据库或其他系统，保持数据一致

关键注意事项 #

• 权限配置：需要申请Calendars.ReadWrite应用权限（后台同步场景用应用权限更合适，委托权限适合用户交互场景）
• 订阅续订：Graph订阅最长有效期为3天，要在应用里加定时任务，自动续订即将过期的订阅
• 幂等处理：同步时要处理重复通知，比如用事件的id和lastModifiedDateTime判断是否已经处理过该变更

内容的提问来源于stack exchange，提问作者Ken Robison