创建邮件组
POST/v2/groups
在当前组织中创建邮件组。邮件组邮箱地址必须可用,所属域名必须存在且未被冻结。
Request
请求体参数
- NORMAL: 正常
- FREEZE: 冻结
- ANYONE:
- SAME_ORGANIZATION:
- GROUP_MEMBER:
- ONLY_ALLOWED_SENDER:
- GROUP_MEMBER_AND_ALLOWED_SENDER:
- STATIC: 静态组
- DEPARTMENT: 部门组
- DYNAMIC: 动态组
- USERGROUP: 群组
- DING: 钉钉组
组名
组邮件地址
状态,仅管理员或授权应用可修改
Possible values: [NORMAL, FREEZE]
管理员,仅管理员或授权应用可修改(可选字段:在URL中增加$select=admins查询参数后返回,如需多个字段使用英文逗号分隔)
是否需要消息投递审核,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=needMessageDeliveryReview查询参数后返回,如需多个字段使用英文逗号分隔)
消息投递审核员,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=messageDeliveryReviewers查询参数后返回,如需多个字段使用英文逗号分隔)
可发消息给该组的人员,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=allowedSenders查询参数后返回,如需多个字段使用英文逗号分隔)
允许哪些人发消息给该组,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=allowedSenderPolicy查询参数后返回,如需多个字段使用英文逗号分隔)
Possible values: [ANYONE, SAME_ORGANIZATION, GROUP_MEMBER, ONLY_ALLOWED_SENDER, GROUP_MEMBER_AND_ALLOWED_SENDER]
组类型,仅管理员或授权应用可访问(可选字段:在URL中增加$select=type查询参数后返回,如需多个字段使用英文逗号分隔)
Possible values: [STATIC, DEPARTMENT, DYNAMIC, USERGROUP, DING]
动态组成员匹配规则,仅管理员或授权应用 可访问,可修改(可选字段:在URL中增加$select=dynamicMatchRule查询参数后返回,如需多个字段使用英文逗号分隔)
最大成员数限制,不超过100000,仅管理员或授权应用可修改(可选字段:在URL中增加$select=itemCountLimit查询参数后返回,如需多个字段使用英文逗号分隔)
归属部门(可选字段:在URL中增加$select=departmentId查询参数后返回,如需多个字段使用英文逗号分隔)
是否在通讯录显示此组,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=isHidden查询参数后返回,如需多个字段使用英文逗号分隔)
忽略成员的自动回复,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=ignoreAutoReplyOfMember查询参数后返回,如需多个字段使用英文逗号分隔)
是否发送通知信给新加入的成员,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=sendMessageToNewMember查询参数后返回,如需多个字段使用英文逗号分隔)
成员退出是否需要管理员审核,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=requireApprovalWhenMemberLeaves查询参数后返回,如需多个字段使用英文逗号分隔)
成员是否仅管理员可见,仅管理员或授权应用可修改(可选字段:在URL中增加$select=memberOnlyVisibleToAdmin查询参数后返回,如需多个字段使用英文逗号分隔)
响应
- NORMAL: 正常
- FREEZE: 冻结
- ANYONE:
- SAME_ORGANIZATION:
- GROUP_MEMBER:
- ONLY_ALLOWED_SENDER:
- GROUP_MEMBER_AND_ALLOWED_SENDER:
- STATIC: 静态组
- DEPARTMENT: 部门组
- DYNAMIC: 动态组
- USERGROUP: 群组
- DING: 钉钉组
id
组名
组邮件地址
状态,仅管理员或授权应用可修改
Possible values: [NORMAL, FREEZE]
创建时间
一级静态成员数
管理员,仅管理员或授权应用可修改(可选字段:在URL中增加$select=admins查询参数后返回,如需多个字段使用英文逗号分隔)
是否需要消息投递审核,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=needMessageDeliveryReview查询参数后返回,如需多个字段使用英文逗号分隔)
消息投递审核员,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=messageDeliveryReviewers查询参数后返回,如需多个字段使用英文逗号分隔)
可发消息给该组的人员,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=allowedSenders查询参数后返回,如需多个字段使用英文逗号分隔)
允许哪些人发消息给该组,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=allowedSenderPolicy查询参数后返回,如需多个字段使用英文逗号分隔)
Possible values: [ANYONE, SAME_ORGANIZATION, GROUP_MEMBER, ONLY_ALLOWED_SENDER, GROUP_MEMBER_AND_ALLOWED_SENDER]
组类型,仅管理员或授权应用可访问(可选字段:在URL中增加$select=type查询参数后返回,如需多个字段使用英文逗号分隔)
Possible values: [STATIC, DEPARTMENT, DYNAMIC, USERGROUP, DING]
动态组成员匹配规则,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=dynamicMatchRule查询参数后返回,如需多个字段使用英文逗号分隔)
最大成员数限制,不超过100000,仅管理员或授权应用可修改(可选字段:在URL中增加$select=itemCountLimit查询参数后返回,如需多个字段使用英文逗号分隔)
是否包含外部成员(可选字段:在URL中增加$select=containOuterMember查询参数后返回,如需多个字段使用英文逗号分隔)
归 属部门(可选字段:在URL中增加$select=departmentId查询参数后返回,如需多个字段使用英文逗号分隔)
是否在通讯录显示此组,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=isHidden查询参数后返回,如需多个字段使用英文逗号分隔)
创建者 email,仅管理员或授权应用可访问(可选字段:在URL中增加$select=creator查询参数后返回,如需多个字段使用英文逗号分隔)
最后一次收到消息的时间(可选字段:在URL中增加$select=lastRecvMessageTime查询参数后返回,如需多个字段使用英文逗号分隔)
忽略成员的自动回复,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=ignoreAutoReplyOfMember查询参数后返回,如需多个字段使用英文逗号分隔)
是否发送通知信给新加入的成员,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=sendMessageToNewMember查询参数后返回,如需多个字段使用英文逗号分隔)
成员退出是否需要管理员审核,仅管理员或授权应用可访问,可修改(可选字段:在URL中增加$select=requireApprovalWhenMemberLeaves查询参数后返回,如需多个字段使用英文逗号分隔)
成员是否仅管理员可见,仅管理员或授权应用可修改(可选字段:在URL中增加$select=memberOnlyVisibleToAdmin查询参数后返回,如需多个字段使用英文逗号分隔)
错误
400 | Bad Request |
401 | 访问未授权,请检查是否传递了正确的授权token |
403 | 无API访问权限,请在域管的应用管理页面完成相关授权 |
404 | Not Found |
409 | Conflict |
412 |