通过

组资源类型

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示Microsoft Entra组，可以是Microsoft 365 组、Microsoft Teams 中的团队或安全组。 此资源是允许传入其他属性的开放类型。

继承自 directoryObject。

出于性能原因，默认情况下 create、get 和 list 操作仅返回更常用属性的子集。 这些默认属性将记录在属性部分中。 若要获取默认情况下不返回的任何属性，请在 OData 查询选项中 $select 指定它们。

该资源支持：

Microsoft Teams 和 Microsoft 365 组支持组协作 。 您可结合使用大多数的 Microsoft 365 组 API 与 Microsoft Teams。 若要创建团队，首先要创建组，然后向组添加团队。 有关详细信息，请参阅 Microsoft Teams 概述。

方法

方法 返回类型 Description
List group 集合 读取所有 group 对象的属性和关系。
创建 group 新建指定的组。 它可以是 Microsoft 365 组、动态组、安全组，或者团队。
获取 group 读取 group 对象的属性和关系。
更新 无 更新 group 对象的属性。
删除 无 删除组对象。
获取增量 group 集合 获取组的增量更改。
Upsert 组 如果不存在，请创建新组，或更新现有组的属性。
组管理
List members directoryObject 集合 从 members 导航属性中获取属于此组的直接成员的用户和组。
添加成员 directoryObject 通过发布到 成员导航属性 （ (仅支持安全组和Microsoft 365 个组) ）来向此组添加成员。
删除成员 无 通过 members 导航属性，删除 Microsoft 365 组或安全组的成员。
List owners directoryObject 集合 从 owners 导航属性中获取此组的所有者。
Add owner directoryObject 通过发布到 owners 导航属性为组添加新所有者（仅支持安全组和 Microsoft 365 组）。
Remove owner 无 通过 owners 导航属性，删除 Microsoft 365 组或安全组的所有者。
List endpoints endpoint 集合 获取 endpoint 对象集合。
Get endpoint endpoint 读取 endpoint 对象的属性和关系。
列出隶属于 directoryObject 集合 通过 memberOf 导航属性，获取此组是其直接成员的组和管理单元。
列出组生命周期策略 groupLifecyclePolicy 集合 列出组生命周期策略。
List transitive members directoryObject 集合 获取属于此组成员（包括嵌套成员）的用户、组、设备和服务主体。
列出 的可传递成员 directoryObject 集合 列出此组所属的组和管理单元。 此操作是可传递的，并包括此组以嵌套方式所属的组。
分配许可证 组 为组添加或删除订阅。 还可以启用和禁用与订阅相关的特定计划。
评估动态成员身份 evaluateDynamicMembershipResult 评估用户或设备是否为动态组的成员。
续订 Boolean 续订组以更新到期时间。 续订后，组的有效期就会延长策略中定义的天数。
验证属性 JSON 验证符合命名策略的 Microsoft 365 组的显示名称或邮件昵称。
应用角色分配
List appRoleAssignment 集合 获取已向其分配此组的应用和应用角色。
添加 appRoleAssignment 向此组分配一个应用角色。
Remove 无。 从此组中删除一个应用角色分配。
Calendar
Get calendar calendar 获取组的日历。
更新日历 None 更新组的日历。
List events event 集合 获取 event 对象集合。
Create event event 通过发布到事件集合新建事件。
获取事件 event 读取 event 对象的属性。
更新事件 无 更新 event 对象的属性。
删除事件 无 删除 event 对象。
列出日历视图 event 集合 获取指定时间范围内的事件集合。
云许可
列表使用权限 microsoft.graph.cloudLicensing.usageRight 集合 获取授予组的 usageRight 对象的列表。
正确使用 microsoft.graph.cloudLicensing.usageRight 获取授予组的 usageRight 对象的属性和关系。
对话
列出对话 conversation 集合 获取 conversation 对象集合。
创建对话 conversation 通过发布到对话集合新建对话。
获取对话 conversation 读取 conversation 对象的属性。
删除对话 无 删除 conversation 对象。
列出线程 conversationThread 集合 获取某个组的所有线程。
创建线程 conversationThread 创建新的对话线程。
获取线程 conversationThread 读取 thread 对象的属性。
更新线程 无 更新 thread 对象的属性。
删除线程 无 删除 thread 对象
列出接受的发送者 directoryObject collection 获取此组的“接受的发件人”列表中的用户或组列表。
添加接受的发件人 directoryObject 将用户或组添加到 acceptSenders 集合。
删除接受的发送者 directoryObject 从 acceptedSenders 集合中删除用户或组。
列出拒绝的发送者 directoryObject collection 获取此组的“遭拒的发件人”列表中的用户或组列表。
添加拒绝的发件人 directoryObject 将新用户或组添加到 rejectedSenders 集合中。
删除拒绝的发件人 directoryObject 从 rejectedSenders 集合中删除新用户或组。
目录对象
List deleted items directoryObject collection 检索租户中过去 30 天内被删除的组。
Get deleted item directoryObject collection 按 ID 检索已删除的组。
Restore deleted item directoryObject collection 还原最近 30 天内在租户中删除的组。
永久删除项目 directoryObject collection 从租户中永久删除已删除的组。
列出用户拥有的已删除项目 directoryObject collection 检索过去 30 天内在租户中删除的组，这些组由用户拥有。
检查成员组 String collection 检查组列表中的成员身份。 此函数可传递。
获取成员组 字符串集合 返回组所属的所有组。 此函数可传递。
检查成员对象 String 集合 检查组、目录角色或管理单元对象列表中的成员身份。 此函数可传递。
获取成员对象 字符串集合 返回组所属的所有组和管理单元。 此函数可传递。
驱动器
获取驱动器 drive 检索 Drive 资源的属性和关系。
列出子项 driveItem 集合 返回 driveItem 的子关系中的 driveItem 对象的集合。
组设置
List directorySetting 集合 列出所有设置对象的属性。
创建 directorySetting 基于 directorySettingTemplate 创建设置对象。 POST 请求必须为模板中定义的所有设置提供 settingValues。 此操作只能使用组特定的模板。
Get directorySetting 读取特定设置对象的属性。
更新 无 更新 setting 对象。
删除 无 删除 setting 对象。
列出设置模板 无 列出所有设置模板的属性。
获取设置模板 无 读取设置模板的属性。
注意
列出笔记本 notebook 集合 检索 notebook 对象列表。
创建笔记本 笔记本 新建 OneNote 笔记本。
基于密码的单一登录凭据
获取 passwordSingleSignOnCredentialSet 集合 获取此组的基于密码的单一登录凭据列表。 密码永远不会返回，而是始终返回为 null。
删除 None 删除与此组关联的给定服务主体的基于密码的单一登录凭据。
名字。
个人资料照片
Get profilePhoto 获取指定的 profilePhoto 或其元数据（profilePhoto 属性）。
更新 无 更新租户中任意用户的照片，其中包括已登录用户或指定的组或联系人。
删除 None 删除租户中任何用户（包括已登录用户或指定组）的照片。
计划表
列出计划 plannerPlan 集合 获取分配给组的计划。
帖子
List 帖子 集合 获取对话线程中的帖子。
获取 帖子 获取特定帖子。
回复帖子 None 回复帖子。
转发帖子 None 转发帖子。
其他组资源
List permission grants resourceSpecificPermissionGrant 集合 列出授予应用访问组的权限。
用户设置
添加收藏夹 无 将组添加到登录用户的收藏夹组列表中。 仅支持 Microsoft 365 组。
删除收藏夹 无 从登录用户收藏夹组列表中删除组。 仅支持 Microsoft 365 组。
列出隶属于 directoryObject collection 从 memberOf 导航属性获取此用户是其直接成员的组和管理单元。
列出加入的团队 group 集合 获取用户属于其直接成员的相应 Microsoft Teams。
列出关联的团队 associatedTeamInfo 集合 获取 user 与之关联的 Microsoft Teams 中的 associatedTeamInfo 对象的列表。
通过邮件订阅 无 将 isSubscribedByMail 属性设置为 true。 使登录用户可以接收电子邮件对话。 仅支持 Microsoft 365 组。
通过邮件取消订阅 无 将 isSubscribedByMail 属性设置为 false。 禁用已登录用户接收电子邮件对话。 仅支持 Microsoft 365 组。
重置未看计数 None 将登录用户自上次访问以来未看到的所有帖子的 unseenCount 重置为 0。 仅支持 Microsoft 365 组。

属性

重要

仅当使用设置为 eventual 和 $count 的 ConsistencyLevel 标头时，才支持 $filter 和 $search 查询参数的特定用法。 有关详细信息，请参阅 目录对象的高级查询功能。

属性 类型 说明
accessType groupAccessType 指示对组的访问类型。 可能的值为 none、 private、 secret和 public。
allowExternalSenders Boolean 指明组织外部人员能否向群组发送邮件。 默认值为 false。

仅在 $select 上返回。 仅支持"获取组 API"（GET /groups/{ID}）。
assignedLabels assignedLabel 集合 与 Microsoft 365 组关联的敏感度标签对（标签 ID、标签名称）列表。

仅在 $select 上返回。 只有在调用方需要Microsoft Graph 权限和支持的 管理员角色的委托方案中，才能更新此属性。
assignedLicenses assignedLicense 集合 分配给该组的许可证。

仅在 $select 上返回。 支持 $filter（eq）。 只读。
autoSubscribeNewMembers 布尔值 指示是否自动订阅添加到组的新成员以接收电子邮件通知。 可以在组的 PATCH 请求中设置此属性;不要在创建组的初始 POST 请求中设置它。 默认值为 false。

仅在 $select 上返回。 仅支持"获取组 API"（GET /groups/{ID}）。
classification 字符串 描述组 (的分类，例如低、中或高业务影响) 。 通过基于模板定义创建 ClassificationList 设置 值来 定义此属性的有效值。

默认情况下返回。 支持 $filter（eq、ne、not、ge、le、startsWith）。
cloudLicensing microsoft.graph.cloudLicensing.groupCloudLicensing 组与云许可资源的关系。
createdByAppId 字符串 用于创建组的应用 ID 对于部分组可能为 null。

默认情况下返回。 只读。 支持 $filter （eq、 ne、 not、 in、 startsWith）。
createdDateTime DateTimeOffset 组的创建时间戳。 无法修改值，并在创建组时自动填充。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。

默认情况下返回。 只读。
deletedDateTime DateTimeOffset 对于某些Microsoft Entra对象 (用户、组、应用程序) ，如果删除了对象，则首先从逻辑上删除该对象，并且此属性使用删除对象的日期和时间进行更新。 否则此属性为空。 如果对象已还原，则此属性会更新为null。 继承自 directoryObject。
说明 String 可选的组说明。

默认情况下返回。 支持 $filter（eq、ne、not、ge、le、startsWith）和 $search。
displayName String 组的显示名称。 必需。 最大长度为 256 个字符。

默认情况下返回。 支持 $filter（eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq）、$search 和 $orderby。
expirationDateTime DateTimeOffset 设置的组的过期时间戳。 它 null 适用于安全组，但对于Microsoft 365 个组，它表示组设置为何时过期（如 组LifecyclePolicy 中定义）。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。

默认情况下返回。 支持 $filter（eq、ne、not、ge、le、in）。 只读。
groupTypes String collection 指定组类型及其成员身份。

如果集合包含 Unified，则组是Microsoft 365 组;否则，它是安全组或通讯组。 有关详细信息，请参阅组概述。

如果该集合包含 DynamicMembership，则该组具有动态成员身份；否则，成员身份是静态的。

默认情况下返回。 支持 $filter（eq、not）。
hasMembersWithLicenseErrors Boolean 指示此组中是否有该基于组的许可证分配中存在许可证错误的成员。

GET 操作从未返回此属性。 可将它用作 $filter 参数，获取具有许可证错误的成员的组（也就是说，此属性的筛选器为 true）。

支持 $filter（eq）。
hideFromAddressLists Boolean true如果组未显示在 Outlook 用户界面的某些部分：在通讯簿中，在用于选择邮件收件人的地址列表中，以及用于搜索组的“浏览组”对话框中;否则为 false。 默认值为 false。

仅在 $select 上返回。 仅支持"获取组 API"（GET /groups/{ID}）。
hideFromOutlookClients Boolean true如果组未显示在 Outlook 客户端（如 Outlook for Windows 和 Outlook 网页版）中，则为 false，否则为 false。 默认值为 false。

仅在 $select 上返回。 仅支持"获取组 API"（GET /groups/{ID}）。
id String 组的唯一标识符。

默认情况下返回。 继承自 directoryObject。 键。 不可为 null。 只读。

支持 $filter （eq、 ne、 not、 in）。
isArchived Boolean 当组与团队关联时，此属性将确定团队是否处于只读模式。
要读取此属性，请使用 /group/{groupId}/team 终结点或 获取 团队 API。 要更新此属性，请使用 archiveTeam 和 unarchiveTeam API。
isAssignableToRole Boolean 指示是否可以将此组分配给Microsoft Entra角色。 可选。

此属性只能在创建组时设置，并且不可变。 如果设置为 true，则 securityEnabled 属性也必须设置为 true， 可见性 必须为 Hidden，并且组不能是动态组， (即 groupTypes 不能包含 DynamicMembership) 。

只有至少具有特权角色管理员角色的调用方才能设置此属性。 还必须为调用方分配 RoleManagement.ReadWrite.Directory 权限，以设置此属性或更新此类组的成员身份。 有关详细信息，请参阅使用组管理Microsoft Entra角色分配

使用此功能需要Microsoft Entra ID P1 许可证。 默认情况下返回。 支持 $filter （eq、 ne、 not）。
isFavorite Boolean 指示用户是否将组标记为收藏夹。
isManagementRestricted 布尔值 指示组是否是受限管理管理单元的成员。 默认值为 false。 此为只读属性。

若要管理受限管理管理单元的组成员，必须在受限管理管理单元的范围内为管理员或调用应用分配Microsoft Entra角色。
infoCatalogs String 集合 标识分配到组的信息片段。 默认情况下返回。 支持 $filter（eq、not、ge、le、startsWith）。
isSubscribedByMail Boolean 指示登录用户是否订阅接收电子邮件对话。 默认值为 true。

仅在 $select 上返回。 仅支持"获取组 API"（GET /groups/{ID}）。
licenseProcessingState String 指示组许可证分配给所有组成员的状态。 可能的值是：QueuedForProcessing、ProcessingInProgress 和 ProcessingComplete。

仅在 $select 上返回。 只读。
mail String 组的 SMTP 地址，例如“serviceadmins@contoso.com”。

默认情况下返回。 只读。 支持 $filter（eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq）。
mailEnabled 布尔 指定是否为启用邮件的组。 必需。

默认情况下返回。 支持 $filter（eq、ne、not 和 null 值上的 eq）。
mailNickname String 组的邮件别名，它对于组织中的 Microsoft 365 组是唯一的。 最大长度为 64 个字符。 此属性只能包含ASCII 字符集 0 - 127 中的字符，以下除外： @ () \ [] " ; : <> , SPACE。

默认返回。 支持 $filter （eq、 ne、 not、 ge、 le、 in、 startsWith）。
membershipRule String 组为动态组时（groupTypes 包含 DynamicMembership），用于确定该组成员的规则。 有关成员身份规则语法的详细信息，请参阅成员身份规则语法。

默认情况下返回。 支持 $filter（eq、ne、not、ge、le、startsWith）。
membershipRuleProcessingState String 指示动态成员身份处理正在进行中，还是已暂停。 可能的值为 On 或 Paused。

默认情况下返回。 支持 $filter （eq、 ne、 not、 in）。
membershipRuleProcessingStatus membershipRuleProcessingStatus 描述基于规则的动态组的处理状态。 属性 null 适用于非基于规则的动态组，或者如果已暂停动态组处理，则为 。

仅在 $select 上返回。 仅支持"获取组 API"（GET /groups/{ID}）。 只读。
onPremisesDomainName String 包含从本地目录同步的本地域 FQDN（也称为 dnsDomainName）。 仅为通过 Microsoft Entra Connect 将本地目录同步到Microsoft Entra ID的客户填充属性。

默认情况下返回。 只读。
onPremisesLastSyncDateTime DateTimeOffset 指示组上次与本地目录同步的时间。时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。

默认情况下返回。 只读。 支持 $filter （eq、 ne、 not、 ge、 le、 in）。
onPremisesNetBiosName String 包含从本地目录同步的本地 netBios 名称。 仅为通过 Microsoft Entra Connect 将本地目录同步到Microsoft Entra ID的客户填充属性。

默认情况下返回。 只读。
onPremisesProvisioningErrors onPremisesProvisioningError 集合 在预配期间使用 Microsoft 同步产品时发生的错误。

默认情况下返回。 支持 $filter（eq、not）。
onPremisesSamAccountName String 包含从本地目录同步的本地 SAM 帐户名。 仅为通过 Microsoft Entra Connect 将本地目录同步到Microsoft Entra ID的客户填充属性。

默认返回。 支持 $filter （eq、 ne、 not、 ge、 le、 in、 startsWith）。 只读。
onPremisesSecurityIdentifier String 包含从本地同步到云的组的本地安全标识符 (SID) 。 只读。

默认情况下返回。 支持 $filter（eq包括在 null 值上）。
onPremisesSyncEnabled Boolean 如果此组从本地目录同步，则为 true；如果此组最初从本地目录同步，但以后不再同步，则为 false；如果此对象从未从本地目录同步，则为 null（默认值）。

默认情况下返回。 只读。 支持 $filter（eq、ne、not、in 和 null 值上的 eq）。
preferredDataLocation String Microsoft 365 组的首选数据位置。 默认情况下，组继承组创建者的首选数据位置。 若要设置此属性，必须为调用应用授予 Directory.ReadWrite.All 权限，并且至少向用户分配以下Microsoft Entra角色之一：
  • 用户帐户管理员
  • 目录写入程序
  • Exchange 管理员
  • SharePoint 管理员

有关此属性的详细信息，请参阅 OneDrive Online Multi-Geo 和 创建具有特定 PDL 的 Microsoft 365 组。

可为 NULL。 默认情况下返回。
preferredLanguage 字符串 Microsoft 365 组的首选语言。 应遵循 ISO 639-1 代码；例如，en-US。

默认情况下返回。 支持 $filter（eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq）。
proxyAddresses String 集合 指向同一组邮箱的组的电子邮件地址。 例如：["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]。 需要多值属性筛选器表达式的 any 运算符。

默认情况下返回。 只读。 不可为 null。 支持 $filter （eq、 not、 ge、 le、 startsWith、 endsWith、 /$count eq 0、 /$count ne 0）。
renewedDateTime DateTimeOffset 组的上次续订时间戳。 值不能直接修改，只能通过续订服务操作进行更新。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。

默认情况下返回。 支持 $filter（eq、ne、not、ge、le、in）。 只读。
resourceBehaviorOptions 字符串集合 指定在创建期间可为 Microsoft 365 组设置的组行为。 此属性只能在 POST) (创建过程中设置。 有关可能值的列表，请参阅 Microsoft 365 组行为和预配选项。
resourceProvisioningOptions 字符串集合 指定与 Microsoft 365 组关联的组资源。 可能的值为 Team。 有关详细信息，请参阅 Microsoft 365 组行为和预配选项。

默认情况下返回。 支持 $filter （eq、 not、 startsWith。
securityEnabled 布尔 指定是否为安全组。 必需。

默认情况下返回。 支持 $filter （eq、 ne、 not、 in）。
securityIdentifier 字符串 组的安全标识符，用于 Windows 方案。 只读。

默认情况下返回。
serviceProvisioningErrors serviceProvisioningError 集合 联合服务发布的错误，描述与组对象中的属性或链接相关的非暂时性特定于服务的错误。
theme String 指定 Microsoft 365 组的颜色主题。 可能的值为：Teal、Purple、Green、Blue、Pink、Orange 或 Red。

默认情况下返回。
唯一名称 String 可分配给组并用作备用键的唯一标识符。 不可变。 只读。
unseenConversationsCount Int32 自已登录用户上次访问组以来，已发送一个或多个新帖子的对话计数。 此属性与 unseenCount 相同。

仅在 $select 上返回。
unseenCount Int32 自登录用户上次访问该组以来收到新帖子的对话计数。 此属性与 unseenConversationsCount 相同。

仅在 $select 上返回。 仅支持"获取组 API"（GET /groups/{ID}）。
unseenMessagesCount Int32 自登录用户上次访问该组以来已传递到组对话的新帖子计数。

仅在 $select 上返回。
visibility String 指定组的组加入策略和组内容可见性。 可能的值为： Private、 Public或 HiddenMembership。 HiddenMembership 只能在创建组时为 Microsoft 365 个组设置。 以后无法更新它。 创建组后，可更新其他可见性值。
如果在 Microsoft Graph 上创建组期间未指定可见性值，则默认情况下会创建 Private 安全组，Microsoft 365 组为 Public。 可分配给角色的组始终为 Private。 若要了解详细信息，请参阅 组可见性选项。

默认情况下返回。 可为 NULL。
writebackConfiguration groupWritebackConfiguration 指定是否将组配置为将组对象属性写回本地 Active Directory。 在 Microsoft Entra Connect 同步客户端中配置组写回时，会使用这些属性。

组可见性选项

值 说明
公共 任何人都可以在未经所有者许可的情况下加入组。
任何人都可以查看组的内容。
私人 需要所有者许可才能加入组。
非成员无法查看组的内容。
HiddenMembership 需要所有者许可才能加入组。
非成员无法查看组的内容。
非成员无法查看组的成员。
管理员（全局、公司、用户和支持人员）可以查看组的成员资格。
该组显示在全局通讯簿 (GAL) 中。

关系

关系 类型 说明
acceptedSenders directoryObject 集合 允许在此组中创建帖子或日历事件的用户或组列表。 如果此列表不为空，则只有此处列出的用户或组才能发布。
appRoleAssignments appRoleAssignment 集合 表示组已对应用程序授予的应用角色。 支持 $expand。
日历 日历 组日历。 只读。
calendarView event 集合 日历的日历视图。 只读。
conversations 对话 集合 组对话。
createdOnBehalfOf directoryObject 创建组的用户（或应用程序）。 注意： 如果用户是管理员，则不会设置此设置。 只读。
drive drive 组的默认驱动器。 只读。
drives drive 集合 组的驱动器。 只读。
endpoints Endpoint 集合 组的终结点。 只读。 可为 NULL。
events event 集合 组事件。
extensions 扩展集合 为组定义的开放扩展的集合。 此为只读属性。 可为 NULL。
groupLifecyclePolicies groupLifecyclePolicy 集合 此组的生命周期策略集合。 只读。 可为 NULL。
memberOf directoryObject 集合 此组所属的组和管理单元。 HTTP 方法：GET（支持所有组） 只读。 可为 NULL。 支持 $expand。
members directoryObject collection 直接组成员，可以是用户、设备、其他组或服务主体。 支持列出成员、添加成员和删除成员操作。 可为 NULL。
支持$expand包括嵌套$select。 例如，/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName)。
membersWithLicenseErrors user 集合 在该基于组的许可证分配中存在许可证错误的组成员列表。 只读。
onenote onenote 只读。
owners directoryObject collection 组的所有者，可以是用户或服务主体。 仅限 100 个所有者。 可为 NULL。
  • 如果在创建 Microsoft 365 组时未指定此属性，则自动将呼叫用户 (管理员或非管理员) 分配为组所有者。
  • 非管理员用户在创建组时无法显式将自己添加到此集合。 有关详细信息，请参阅相关的 已知问题。
  • 对于安全组，管理员用户不会自动添加到此集合。 有关详细信息，请参阅相关的 已知问题。

    支持 $filter (/$count eq 0、、/$count ne 0/$count eq 1、 /$count ne 1) ;支持$expand包括嵌套 。$select 例如，/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName)。
    		•
    permissionGrants resourceSpecificPermissionGrant 为组授予的特定应用程序的权限。 支持 $expand。
    photo profilePhoto 组的个人资料照片。
    photos profilePhoto 集合 组拥有的个人资料照片。 此为只读属性。 可为 NULL。
    planner plannerGroup 组可用的选择性 Planner 服务。 只读。 可为 NULL。
    rejectedSenders directoryObject 集合 不允许在此组中创建帖子或日历事件的用户或组列表。 可为空
    settings directorySetting 集合 可以管理此组行为的设置，例如成员是否可以将来宾用户邀请到此组。 可为 NULL。
    sites 网站集 此组中的 SharePoint 网站列表。 使用 /sites/root 访问默认站点。
    团队 channel 集合 与此组关联的团队。
    threads conversationThread 集合 组的对话线程。 可为 NULL。
    transitiveMemberOf directoryObject 集合 组是其成员的组，无论是直接的还是通过嵌套成员身份。 可为 NULL。
    transitiveMembers directoryObject 集合 组的直接成员和可传递成员。 可为 Null。

    JSON 表示形式

    以下 JSON 表示形式显示了资源类型。

    {
  "accessType": "String",
  "assignedLabels": [{ "@odata.type": "microsoft.graph.assignedLabel" }],
  "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
  "allowExternalSenders": false,
  "autoSubscribeNewMembers": true,
  "cloudLicensing": { "@odata.type": "microsoft.graph.cloudLicensing.groupCloudLicensing" },
  "createdByAppId": "String",
  "createdDateTime": "String (timestamp)",
  "deletedDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "expirationDateTime": "String (timestamp)",
  "groupTypes": ["String"],
  "hideFromAddressLists": false,
  "hideFromOutlookClients": false,
  "id": "String (identifier)",
  "isFavorite": true,
  "isArchived": false,
  "isAssignableToRole": false,
  "isSubscribedByMail": true,
  "licenseProcessingState": "String",
  "mail": "String",
  "mailEnabled": true,
  "mailNickname": "String",
  "onPremisesDomainName": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesNetBiosName": "String",
  "onPremisesProvisioningErrors": [
    { "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
  ],
  "onPremisesSamAccountName": "String",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": true,
  "preferredDataLocation": "String",
  "proxyAddresses": ["String"],
  "renewedDateTime": "String (timestamp)",
  "resourceBehaviorOptions": ["String"],
  "resourceProvisioningOptions": ["String"],
  "securityEnabled": true,
  "securityIdentifier": "String",
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "uniqueName": "String",
  "unseenConversationsCount": 1024,
  "unseenCount": 1024,
  "unseenMessagesCount": 1024,
  "visibility": "String",
  "acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
  "createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "events": [{ "@odata.type": "microsoft.graph.event" }],
  "memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
  "owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
  "rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "sites": [{ "@odata.type": "microsoft.graph.site" }],
  "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
  "classification": "String",
  "hasMembersWithLicenseErrors": true,
  "membershipRule": "String",
  "membershipRuleProcessingState": "String",
  "membershipRuleProcessingStatus": {
    "@odata.type": "microsoft.graph.membershipRuleProcessingStatus"
  },
  "preferredLanguage": "String",
  "theme": "String"
}

    相关内容