使用Graph API筛选通讯组中下月满工作周年的用户

核心逻辑 #

工作周年纪念日基于用户的hireDate（员工雇佣日期），即每年与雇佣日期同月同日的日期。要精准筛选通讯组内下月即将满周年的用户，直接通过Graph API的$filter参数过滤雇佣日期的月份，避免拉取全量用户。

具体实现步骤 #

1. 确定目标月份 #

先算出下月的数字月份：比如当前是5月则目标为6，当前是12月则目标为1。

2. 带筛选条件的Graph API请求 #

调用接口查询指定通讯组的成员，同时筛选hireDate的月份等于目标月份的用户，还可以指定返回必要字段减少数据量：

GET https://graph.microsoft.com/v1.0/groups/{通讯组ID}/members?$filter=month(hireDate) eq {目标月份}&$select=displayName,hireDate

3. 进阶筛选（可选） #

如果需要排除已离职的禁用账户，可在筛选条件中追加accountEnabled eq true：

GET https://graph.microsoft.com/v1.0/groups/{通讯组ID}/members?$filter=month(hireDate) eq {目标月份} and accountEnabled eq true&$select=displayName,hireDate

权限要求 #

确保你的应用已申请GroupMember.Read.All（或更高权限），以读取通讯组成员的hireDate属性。

内容的提问来源于stack exchange，提问作者Bharati Seelam