如何通过Graph API为群组创建Planner私有计划

核心原理 #

Planner计划没有独立的公开/私有属性，其访问权限完全继承所属的Microsoft 365组的可见性配置。你之前创建的计划默认为公开，是因为你传入的owner参数对应的Microsoft 365组本身是公开类型。

操作步骤 #

• 第一步：确认/创建私有类型的Microsoft 365组
  要查询现有组的可见性，调用如下接口：
  GET https://graph.microsoft.com/v1.0/groups/{群组ID}?$select=visibility
  接口返回的visibility字段值为Private即为私有组，Public为公开组。

  如果需要新建私有组，请求示例如下：
  接口地址：POST https://graph.microsoft.com/v1.0/groups
  请求头：Content-type: application/json
  请求体：

  {
    "displayName": "自定义群组名称",
    "mailNickname": "privategroup",
    "securityEnabled": false,
    "mailEnabled": true,
    "groupTypes": ["Unified"],
    "visibility": "Private"
  }
  

• 第二步：基于私有组创建Planner计划
  拿到私有组的ID后，用你原来的创建Planner计划的接口调用即可，传入私有组ID作为owner参数，创建出来的计划就是私有计划，仅私有组成员可访问：
  接口地址：POST https://graph.microsoft.com/v1.0/planner/plans
  请求头：Content-type: application/json
  请求体：

  {
    "owner": "你的私有组ID",
    "title": "计划名称"
  }
  

补充说明 #

• 如果你需要将现有公开组转为私有，可调用接口 PATCH https://graph.microsoft.com/v1.0/groups/{群组ID}，请求体传入"visibility": "Private"即可，修改完成后该组下所有已创建的Planner计划会自动同步为私有权限。
• 调用上述接口的身份需要持有对应权限：创建/修改Microsoft 365组需要Group.ReadWrite.All或Directory.ReadWrite.All权限，创建Planner计划需要Group.ReadWrite.All或Tasks.ReadWrite权限。

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