创建组

使用此 API 可以创建请求正文中指定的新组。可以创建下列 3 种类型之一的组:

  • Office 365 组(统一组)
  • 动态组
  • 安全组

注意:虽然 Microsoft Teams 是在 Office 365 组的基础之上构建而成,但暂不能通过此 API 创建团队。可以使用其他组 API 来管理已在 Microsoft Teams UI 中创建的团队。

权限

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) Group.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。
应用程序 Group.ReadWrite.All

HTTP 请求

POST /groups

请求标头

名称 类型 说明
Authorization string Bearer {token}。必需。

请求正文

下表显示了创建组时至少必须指定的资源的属性。

属性 类型 说明
displayName string 要在组的通讯簿中显示的名称。
mailEnabled 布尔 对于已启用邮件的组,请设置为 true。如果创建 Office 365 组,则将此设置为 true。如果创建动态或安全组,则将此设置为 false
mailNickname string 组的邮件别名。
securityEnabled 布尔 对于启用安全机制的组,请设置为 true。如果创建动态或安全组,则将此设置为 true。如果创建 Office 365 组,则将此设置为 false

如果你正在创建的是 Office 365 或动态组,则按如下所述指定 groupTypes 属性。

组类型 groupTypes 属性
Office 365(也称为统一组) "Unified"
Dynamic "DynamicMembership"
安全性 请勿设置。

根据需要为你的组指定其他可写属性。有关详细信息,请参阅资源的属性。

响应

如果成功,此方法在响应正文中返回 201, Created 响应代码和 group 对象。

示例

请求

下面是创建 Office 365 组的请求的示例。

POST https://graph.microsoft.com/v1.0/groups
Content-type: application/json
Content-length: 244

{
  "description": "Self help community for library",
  "displayName": "Library Assist",
  "groupTypes": [
    "Unified"
  ],
  "mailEnabled": true,
  "mailNickname": "library",
  "securityEnabled": false
}
响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回更多属性。

HTTP/1.1 201 Created
Content-type: application/json
Content-length: 244

{
  "description": "Self help community for library",
  "displayName": "Library Assist",
  "groupTypes": [
    "Unified"
  ],
  "mail": "library@contoso.onmicrosoft.com",
  "mailEnabled": true,
  "mailNickname": "library",
  "securityEnabled": false
}