如何使用Graph API提取SharePoint站点的敏感度标签？

核心解决方案：调用Beta版本站点接口 #

当前v1.0版本的/sites端点暂不返回站点敏感度标签信息，需使用Beta版本接口并指定字段筛选：

请求示例 #

使用站点ID调用：

GET https://graph.microsoft.com/beta/sites/{site-id}?$select=id,name,webUrl,sensitivityLabel

或使用路径格式定位站点：

GET https://graph.microsoft.com/beta/sites/{domain}:/sites/SensitivityLabelTestSite?$select=id,name,webUrl,sensitivityLabel

响应示例片段 #

返回结果中sensitivityLabel字段会包含标签核心信息：

{
  "id": "contoso.sharepoint.com,abc123...",
  "name": "SensitivityLabelTestSite",
  "webUrl": "https://contoso.sharepoint.com/sites/SensitivityLabelTestSite",
  "sensitivityLabel": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "Confidential",
    "displayName": "机密",
    "isActive": true
  }
}

权限配置要求 #

确保应用或账号拥有以下权限之一（需在Azure AD中提前配置）：

• Sites.Read.All（应用权限，适合批量处理场景）
• Sites.ReadWrite.All（应用权限）
• Sites.Read.All（委派权限）

批量处理优化建议 #

搭建微服务批量获取时：

• 采用Beta版本的分页机制，避免单次请求过多站点
• 缓存已获取的标签信息，减少重复API调用
• 增加异常处理逻辑，应对404（站点不存在）或权限错误场景

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