组资源类型
命名空间:microsoft.graph
重要
Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
表示 Azure Active Directory (Azure AD) 组,可以是 Microsoft 365 组、Microsoft Teams 中的团队,或者安全组。 此资源是允许传入其他属性的开放类型。
继承自 directoryObject。
出于性能原因,默认情况下 create、get 和 list 操作仅返回更常用属性的子集。 这些 默认 属性将记录在 属性部分中。 若要获取非默认返回的任一属性,请在 $select OData 查询选项中指定这些属性。
该资源支持:
Microsoft Teams 和 Microsoft 365 组支持组协作。 您可结合使用大多数的 Microsoft 365 组 API 与 Microsoft Teams。 若要创建团队,首先要创建组,然后向组添加团队。 有关详细信息,请参阅 Microsoft Teams 概述。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 组管理 | ||
| Create group | 组 | 按指定方式创建新组。可以是 Microsoft 365 组、动态组、安全组或团队。 |
| Get group | group | 读取 group 对象的属性和关系。 |
| Update group | 无 | 更新 group 对象的属性。 |
| 删除组 | 无 | 删除组对象。 |
| List groups | group | 读取所有 group 对象的属性和关系。 |
| delta | 组集合 | 获取组的增量更改。 |
| 添加成员 | directoryObject | 通过发布到 members 导航属性将用户或组添加到此组(仅支持安全组和 Microsoft 365 组)。 |
| 添加所有者 | directoryObject | 通过发布到 owners 导航属性为组添加新所有者(仅支持安全组和 Microsoft 365 组)。 |
| Create setting | directorySetting | 基于 directorySettingTemplate 创建设置对象。POST 请求必须为模板中定义的所有设置提供 settingValues。只有组特定模板可用于此操作。 |
| 删除设置 | 无 | 删除 setting 对象。 |
| Get endpoint | endpoint | 读取 endpoint 对象的属性和关系。 |
| Get setting | directorySetting | 读取特定设置对象的属性。 |
| List endpoints | endpoint 集合 | 获取 endpoint 对象集合。 |
| List members | directoryObject 集合 | 从 members 导航属性中获取属于此组的直接成员的用户和组。 |
| List memberOf | directoryObject 集合 | 通过 memberOf 导航属性,获取此组是其直接成员的组和管理单元。 |
| 列出 groupLifecyclePolicy | groupLifecyclePolicy 集合 | 列出组生命周期策略。 |
| List owners | directoryObject 集合 | 从 owners 导航属性中获取此组的所有者。 |
| List settings | directorySetting 集合 | 列出所有设置对象的属性。 |
| List transitive members | directoryObject 集合 | 获取属于此组成员(包括嵌套成员)的用户、组、设备和服务主体。 |
| List transitive memberOf | directoryObject 集合 | 列出此组所属的组和管理单元。 此操作是可传递的,并包括此组以嵌套方式所属的组。 |
| 删除所有者 | 无 | 通过 owners 导航属性,删除 Microsoft 365 组或安全组的所有者。 |
| 删除成员 | 无 | 通过 members 导航属性,删除 Microsoft 365 组或安全组的成员。 |
| Update setting | directorySetting | 更新 setting 对象。 |
| assignLicense | 组 | 为群组添加或删除订阅。还可以启用和禁用与订阅相关的特定计划。 |
| evaluateDynamicMembership | evaluateDynamicMembershipResult | 评估用户或设备是否为动态组的成员。 |
| 续订 | 布尔值 | 续订组以更新到期时间。续订后,组的有效期就会延长策略中定义的天数。 |
| validateProperties | JSON | 验证 Microsoft 365 组的显示名称或邮件昵称是否符合命名策略。 |
| 应用角色分配 | ||
| 列出 appRoleAssignments | appRoleAssignment 集合 | 获取已分配到此组的应用和应用角色。 |
| 添加 appRoleAssignment | appRoleAssignment | 向此组分配一个应用角色。 |
| 删除 appRoleAssignment | 无。 | 从此组中删除一个应用角色分配。 |
| Calendar | ||
| 创建事件 | event | 通过发布到事件集合新建事件。 |
| 获取事件 | event | 读取 event 对象的属性。 |
| 列出事件 | event 集合 | 获取 event 对象集合。 |
| 更新事件 | 无 | 更新 event 对象的属性。 |
| 删除事件 | 无 | 删除 event 对象。 |
| 列出 calendarView | event 集合 | 获取指定时间范围内的事件集合。 |
| 对话 | ||
| 创建对话 | conversation | 通过发布到对话集合新建对话。 |
| 获取对话 | conversation | 读取 conversation 对象的属性。 |
| 列出对话 | conversation 集合 | 获取 conversation 对象集合。 |
| 删除对话 | 无 | 删除 conversation 对象。 |
| 创建线程 | conversationThread | 创建新的对话线程。 |
| 获取线程 | conversationThread | 读取 thread 对象的属性。 |
| 列出线程 | conversationThread 集合 | 获取组的所有线程。 |
| 更新线程 | 无 | 更新 thread 对象的属性。 |
| 删除线程 | 无 | 删除 thread 对象 |
| List acceptedSenders | directoryObject collection | 获取此组的“接受的发件人”列表中的用户或组列表。 |
| 添加 acceptedSender | directoryObject | 将用户或组添加到 acceptSenders 集合。 |
| 删除 acceptedSender | directoryObject | 从 acceptedSenders 集合中删除用户或组。 |
| List rejectedSenders | directoryObject collection | 获取此组的“遭拒的发件人”列表中的用户或组列表。 |
| Add rejectedSender | directoryObject | 将新用户或组添加到 rejectedSenders 集合中。 |
| Remove rejectedSender | directoryObject | 从 rejectedSenders 集合中删除新用户或组。 |
| 目录对象 | ||
| 列出已删除的组 | directoryObject collection | 检索租户中过去 30 天内被删除的组。 |
| 列出用户拥有的已删除组 | directoryObject collection | 检索租户中最近 30 天内删除的用户所有的组。 |
| 获取已删除的组 | directoryObject collection | 按 ID 检索已删除的组。 |
| 恢复已删除的组 | directoryObject collection | 还原最近 30 天内在租户中删除的组。 |
| 永久删除组 | directoryObject collection | 从租户中永久删除已删除的组。 |
| checkMemberGroups | String 集合 | 在一列组中检查成员身份。此函数是可传递的。 |
| getMemberGroups | String collection | 返回此组是其成员的所有组。此函数是可传递的。 |
| checkMemberObjects | String 集合 | 检查组、目录角色或管理单元对象列表中的成员身份。该函数可传递。 |
| getMemberObjects | String 集合 | 返回组所属的所有组和管理单元。此函数是可传递的。 |
| 开放扩展 | ||
| 创建开放扩展 | openTypeExtension | 创建开放扩展,并将自定义属性添加到新资源或现有资源。 |
| 获取开放扩展 | openTypeExtension 集合 | 获取扩展名称标识的开放扩展。 |
| 架构扩展 | ||
| 添加架构扩展值 | 无 | 创建架构扩展定义,然后使用它向资源添加自定义键入数据。 |
| 其他组资源 | ||
| List photos | profilePhoto 集合 | 获取组的个人资料照片集合。 |
| List plannerPlans | plannerPlan 集合 | 获取组拥有的 Planner 计划。 |
| List permissionGrants | resourceSpecificPermissionGrant 集合 | 列出已授予应用访问组的权限。 |
| 用户设置 | ||
| addFavorite | 无 | 将组添加到登录用户的收藏夹组列表中。仅支持 Microsoft 365 组。 |
| removeFavorite | 无 | 从登录用户收藏夹组列表中删除组。仅支持 Microsoft 365 组。 |
| List memberOf | directoryObject 集合 | 通过 memberOf 导航属性,获取此用户为其直接成员的组和管理单元。 |
| List joinedTeams | group 集合 | 获取用户属于其直接成员的相应 Microsoft Teams。 |
| 列出关联的团队 | associatedTeamInfo 集合 | 获取 user 与之关联的 Microsoft Teams 中的 associatedTeamInfo 对象的列表。 |
| subscribeByMail | 无 | 将 isSubscribedByMail 属性设置为 true。启用已登录用户以接收电子邮件对话。仅支持 Microsoft 365 组。 |
| unsubscribeByMail | 无 | 将 isSubscribedByMail 属性设置为 false。禁用登录用户接收电子邮件对话。仅支持 Microsoft 365 组。 |
| resetUnseenCount | 无 | 将登录用户自上次访问后未查看的所有帖子的 unseenCount 重置为 0。仅支持 Microsoft 365 组。 |
属性
重要
仅当使用设置为 eventual 和 $count 的 ConsistencyLevel 标头时,才支持 $filter 和 $search 查询参数的特定用法。 有关详细信息,请参阅 Azure AD 目录对象的高级查询功能。
| 属性 | 类型 | 说明 | |
|---|---|---|---|
| allowExternalSenders | Boolean | 指示组织外部的人员是否可以向组发送消息。默认值为 false。 仅在 $select返回。仅在 Get 组 API (GET /groups/{ID}) 上受支持。 |
|
| assignedLabels | assignedLabel 集合 | 与 Microsoft 365 组关联的敏感度标签对(标签 ID、标签名称)列表。 仅在 $select 上返回。 |
|
| assignedLicenses | assignedLicense 集合 | 分配给该组的许可证。 仅在 $select上返回。支持 $filter (eq)。只读。 |
|
| autoSubscribeNewMembers | 布尔值 | 指示是否将自动订阅添加到组中的新成员以接收电子邮件通知。可以在组的 PATCH 请求中设置此属性;请勿在创建组的初始 POST 请求中设置它。默认值为 false。 仅在 $select返回。仅在 Get 组 API (GET /groups/{ID}) 上受支持。 |
|
| classification | 字符串 | 描述该组的分类(如低、中或高业务影响)。通过根据模板定义创建 ClassificationList 设置值来定义此属性的有效值。 默认返回。支持 $filter(eq、ne、not、ge、le、startsWith)。 |
|
| createdByAppId | 字符串 | 用于创建组的应用 ID 对于部分组可能为 null。 默认情况下返回。支持 $filter (eq, ne, not, in, startsWith)。 |
|
| createdDateTime | DateTimeOffset | 组的创建时间戳。 值无法修改,并在组创建时自动填充。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 默认情况下返回。支持 $filter (eq, ne, not, ge, le, in)。只读。 |
|
| deletedDateTime | DateTimeOffset | 对于某些Azure Active Directory对象(用户、组、应用程序),如果删除对象,则首先在逻辑上删除该对象,并且此属性将更新为删除对象的日期和时间。否则,此属性为 null。如果还原对象,则此属性将更新为 null。 | |
| 说明 | 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 | 设置的组的过期时间戳。 值无法修改,并在组创建时自动填充。 时间戳类型表示采用 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 | 如果 Outlook 用户界面的某些部分中未显示该组,则为 true:在 通讯簿 中、在选择邮件收件人的地址列表中,以及用于搜索组的 浏览组 对话框中;否则为 false。默认值为 false。 仅在 $select返回。仅在 Get 组 API (GET /groups/{ID}) 上受支持。 |
|
| hideFromOutlookClients | Boolean | 如果在 Outlook 客户端(如 Outlook for Windows 和 Outlook 网页版)中未显示改组,则为 true,否则为 false。默认值为 false。 仅在 $select 上返回。仅在 Get 组 API(GET /groups/{ID})上受支持。 |
|
| id | String | 组的唯一标识符。 默认情况下返回。 继承自 directoryObject。 键。 不可为 null。 只读。 支持 $filter (eq、 ne、 not、 in)。 |
|
| isArchived | Boolean | 当组与团队关联时,此属性将确定团队是否处于只读模式。 要读取此属性,请使用 /group/{groupId}/team 终结点或 获取 团队 API。 要更新此属性,请使用 archiveTeam 和 unarchiveTeam API。 |
|
| isAssignableToRole | Boolean | 指示是否可以将此组分配给 Azure Active Directory 角色。 可选。 此属性只能在创建组时设置,并且不可变。 如果设置为 true,则 securityEnabled 属性也必须设置为 true,并且该组不能是动态组(即,groupTypes 不能包含 DynamicMembership)。 只有全局管理员和特权角色管理员角色中的调用方可以设置此属性。 必须向调用方分配 RoleManagement.ReadWrite.Directory 权限,才能设置此属性或更新此类组成员的身份。 有关更多信息,请参阅使用组来管理 Azure AD 角色分配默认返回。支持 $filter(eq、ne、not)。 |
|
| infoCatalogs | 字符串集合 | 标识分配给组的信息段。默认返回。支持 $filter(eq、not、ge、le、startsWith) |
|
| isSubscribedByMail | Boolean | 指示是否订阅已登录用户以接收电子邮件对话。默认值为 true。 仅在 $select 上返回。仅在 Get 组 API(GET /groups/{ID})上受支持。 |
|
| licenseProcessingState | String | 指示对该组所有成员的组许可证分配的状态。可能的值:QueuedForProcessing、ProcessingInProgress 和 ProcessingComplete。 仅在 $select 返回。只读。 |
|
| String | 组的 SMTP 地址,例如,“serviceadmins@contoso.onmicrosoft.com”。 默认情况下返回。 只读。 支持 $filter(eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq)。 |
||
| mailEnabled | Boolean | 指定组是否启用邮件。必需。 默认情况下返回。 支持 $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 上返回。仅在 Get 组 API (GET /groups/{ID}) 上受支持。只读。 |
|
| onPremisesDomainName | String | 包含从本地目录同步的本地 域 FQDN,也称为 dnsDomainName。仅为正在通过 Azure AD Connect 将其本地目录同步到 Azure Active Directory 的客户填充该属性。 默认返回。只读。 |
|
| onPremisesLastSyncDateTime | DateTimeOffset | 指示上次将组与本地目录同步的时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终采用 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 2014-01-01T00:00:00Z。 默认情况下返回。只读。支持 $filter(eq、ne、not、ge、le、in)。 |
|
| onPremisesNetBiosName | String | 包含从本地目录同步的本地 netBios 名称。仅为通过 Azure AD Connect 将其本地目录同步到 Azure Active Directory 的客户填充该属性。 默认返回。只读。 |
|
| onPremisesProvisioningErrors | onPremisesProvisioningError 集合 | 在预配期间使用 Microsoft 同步产品时发生的错误。 默认返回。支持 $filter(eq、not)。 |
|
| onPremisesSamAccountName | String | 包含从本地目录同步的本地 SAM 帐户名称。该属性仅为通过 Azure AD Connect 将其本地目录同步到 Azure Active Directory 的客户填充。 默认情况下返回。支持 $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 组的首选数据位置。 默认情况下,组继承组创建者的首选数据位置。 若要设置此属性,必须为调用用户分配以下 Azure AD 角色之一:
有关此属性详细信息,请参阅 OneDrive Online 多地理位置。 默认返回。可为空。 |
|
| preferredLanguage | String | 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 和计数空集合)。 |
|
| 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)。 可取值为:AllowOnlyMembersToPost、HideGroupInOutlook、SubscribeNewGroupMembers、WelcomeEmailDisabled。 有关详细信息,请参阅 设置 Microsoft 365 组行为和预配选项 。 |
|
| resourceProvisioningOptions | 字符串集合 | 指定预配为创建 Microsoft 365 组的一部分,但通常不是创建默认组的组资源。 可能值为 Team。 有关详细信息,请参阅 设置 Microsoft 365 组行为和预配选项 。 默认返回。支持 $filter(eq、not、startsWith。 |
|
| securityEnabled | Boolean | 指定组是否为安全组。必需。 默认返回。支持 $filter(eq、ne、not、in)。 |
|
| securityIdentifier | 字符串 | 组的安全标识符,用于 Windows 方案。 默认情况下返回。 |
|
| theme | String | 指定 Microsoft 365 组的颜色主题。 可能的值为:Teal、Purple、Green、Blue、Pink、Orange 或 Red。 默认情况下返回。 |
|
| unseenConversationsCount | Int32 | 自登录用户上次访问该组以来已传递一个或多个新帖子的对话计数。此属性与 unseenCount 相同。 仅在 $select 上返回。 |
|
| unseenCount | Int32 | 自登录用户上次访问该组以来已收到新帖子的对话计数。此属性与 unseenConversationsCount 相同。 仅在 $select 上返回。仅在 Get 组 API(GET /groups/{ID})上受支持。 |
|
| unseenMessagesCount | Int32 | 自登录用户上次访问该组以来已传递到组对话的新帖子计数。 仅在 $select 上返回。 |
|
| visibility | String | 指定组的组加入策略和组内容可见性。 可能的值为: Private、 Public或 HiddenMembership。 HiddenMembership 仅在创建组时,<a0/&;为 Microsoft 365 组设置 <a2/&;。 以后无法更新它。 创建组后,可更新其他可见性值。如果在 Microsoft Graph 上的组创建期间未指定可见性值,则默认创建安全组 Private Microsoft 365 组 Public。 可分配给角色的组始终为 Private。 请参阅组可见性选项以了解详细信息。 默认情况下返回。 可为 NULL。 |
|
| writebackConfiguration | groupWritebackConfiguration | 指定是否将组配置为将组对象属性写回本地 Active Directory。 在 Azure AD Connect 同步客户端中配置组写回时,将使用这些属性。 |
组可见性选项
| 值 | 说明 |
|---|---|
| 公共 | 任何人均可在不需要所有者许可的情况下加入组。 任何人均可查看组的内容。 |
| 私人 | 需要所有者许可才能加入组。 非成员无法查看组的内容。 |
| HiddenMembership | 需要所有者许可才能加入组。 非成员无法查看组的内容。 非成员无法查看组的成员。 管理员(全局、公司、用户和支持人员)可以查看组的成员资格。 该组显示在全局通讯簿 (GAL) 中。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| acceptedSenders | directoryObject 集合 | 允许在此组中创建帖子或日历事件的用户或组列表。如果此列表为非空,则仅允许此处列出的用户或组发布内容。 |
| appRoleAssignments | appRoleAssignment 集合 | 表示已为应用程序授予组的应用角色。支持 $expand。 |
| 日历 | 日历 | 组日历。只读。 |
| calendarView | 事件 集合 | 日历的日历视图。只读。 |
| conversations | 对话 集合 | 组对话。 |
| createdOnBehalfOf | directoryObject | 创建组的用户(或应用程序)。注意: 如果用户是管理员,则不设置此项。只读。 |
| drive | drive | 组的默认驱动器。只读。 |
| drives | drive 集合 | 组的驱动器。只读。 |
| endpoints | Endpoint 集合 | 组的终结点。 只读。 可为 NULL。 |
| events | event 集合 | 组事件。 |
| extensions | 扩展集合 | 为组定义的开放扩展集合。只读。可为 NULL。 |
| groupLifecyclePolicies | groupLifecyclePolicy 集合 | 此组的生命周期策略集合。只读。可为空。 |
| memberOf | directoryObject collection | 此组所属的组和管理单元。HTTP 方法:GET(支持所有组)。只读。可为 Null。支持 $expand。 |
| members | directoryObject 集合 | 此组的直接成员,可以是用户、设备、其他组或服务主体。 支持列出成员、添加成员和删除成员操作。 可为 NULL。 支持 $expand包括嵌套$select。 例如,/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName)。 |
| membersWithLicenseErrors | user 集合 | 在该基于组的许可证分配中存在许可证错误的组成员列表。只读。 |
| onenote | onenote | 只读。 |
| owners | directoryObject collection | 组的所有者,可为用户或服务主体。可为空。如果在创建 Microsoft 365 组时未指定此属性,则会自动将调用用户分配为组所有者。 支持 $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 | 组可以使用的选择性计划程序服务。只读。可为 null。 |
| rejectedSenders | directoryObject 集合 | 不允许在此组中创建帖子或日历事件的用户或组列表。可为 Null |
| 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,
"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,
"isAssignableRole": 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",
"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" },
"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"
}
另请参阅
反馈
提交和查看相关反馈