You need to enable JavaScript to run this app. 如何通过Microsoft Graph API获取SharePoint站点创建者邮箱及站点状态
优惠活动
大模型
产品
解决方案
定价
更多

如何通过Microsoft Graph API获取SharePoint站点创建者邮箱及站点状态

Microsoft Graph API 获取SharePoint站点创建者邮箱与全量状态的实现方案

对应查询语句与实现逻辑

1. 获取站点创建者关联邮箱

  • 常规站点对象默认返回字段不直接包含创建者的邮箱属性,需要通过关联展开createdBy主体字段拉取,该字段和SharePoint站点属性面板中展示的“创建者”信息完全对应
  • 单站点查询请求示例:
    GET https://graph.microsoft.com/v1.0/sites/{目标站点ID}?$select=id,displayName,webUrl&$expand=createdBy($select=id,displayName,userPrincipalName,mail)
    
  • 返回字段说明:createdBy.mail、createdBy.userPrincipalName即为创建者的关联邮箱地址
  • 避坑提示:不要混淆站点owner属性和创建者属性,前者是站点后续配置的当前所有者,后者是站点创建时的初始主体,新站点未配置所有者时owner字段会为空,和目标需求不匹配

2. 获取站点全量状态标识(含活跃、已删除状态)

  • 常规单站点查询仅能识别活跃状态的站点,处于租户SharePoint回收站保留期内的已删除站点,需要通过全量站点集合筛选接口识别
  • 状态判定规则:
    • 可通过指定站点ID的单站点接口正常返回响应:站点处于活跃可用状态
    • 全量站点接口查询筛选出带isDeleted=true标记的记录:站点处于已删除(回收站保留)状态,响应会额外返回deletedDateTime字段标记删除时间
    • 两类查询逻辑均无法返回目标站点记录:站点已被永久删除,不在租户可检索的站点范围内
  • 已删除站点批量查询请求示例:
    GET https://graph.microsoft.com/v1.0/sites?$filter=isDeleted eq true&$select=id,displayName,webUrl,createdBy,deletedDateTime,isDeleted
    

实际使用注意事项

  • 站点列表批量查询接口默认不支持$expand嵌套展开createdBy用户字段,批量场景下需要通过Graph的$batch并发接口逐站点拉取创建者信息,否则会报字段不支持的错误
  • 若站点创建主体为Office 365组或通讯组,返回的创建者邮箱会直接对应组的公共邮箱地址,不会返回单个用户的个人邮箱,属于正常返回结果
  • 已删除站点的查询需要申请对应应用权限:Sites.Read.All,委托权限场景下无法读取租户回收站范围内的站点记录

内容的提问来源于stack exchange,提问作者Santhosh Kumar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 03:06:06