跳到主要内容

更新邮件组信息

PATCH/v2/groups/:id_or_email

根据邮件组 ID 或邮箱地址更新邮件组信息。只读字段和不可变字段不会被修改。

Request​

Path parameters

    id_or_email stringrequired
    • id:
    • email:

请求体参数

    name string

    组名

    status enum

    状态，仅管理员或授权应用可修改

    • NORMAL: 正常
    • FREEZE: 冻结

    Possible values: [NORMAL, FREEZE]

    admins string[]

    管理员，仅管理员或授权应用可修改（可选字段：在URL中增加$select=admins查询参数后返回，如需多个字段使用英文逗号分隔）

    needMessageDeliveryReview boolean

    是否需要消息投递审核，仅管理员或授权应用可访问，可修改（可选字段：在URL中增加$select=needMessageDeliveryReview查询参数后返回，如需多个字段使用英文逗号分隔）

    messageDeliveryReviewers string[]

    消息投递审核员，仅管理员或授权应用可访问，可修改（可选字段：在URL中增加$select=messageDeliveryReviewers查询参数后返回，如需多个字段使用英文逗号分隔）

    allowedSenders string[]

    可发消息给该组的人员，仅管理员或授权应用可访问，可修改（可选字段：在URL中增加$select=allowedSenders查询参数后返回，如需多个字段使用英文逗号分隔）

    allowedSenderPolicy enum

    允许哪些人发消息给该组，仅管理员或授权应用可访问，可修改（可选字段：在URL中增加$select=allowedSenderPolicy查询参数后返回，如需多个字段使用英文逗号分隔）

    • ANYONE:
    • SAME_ORGANIZATION:
    • GROUP_MEMBER:
    • ONLY_ALLOWED_SENDER:
    • GROUP_MEMBER_AND_ALLOWED_SENDER:

    Possible values: [ANYONE, SAME_ORGANIZATION, GROUP_MEMBER, ONLY_ALLOWED_SENDER, GROUP_MEMBER_AND_ALLOWED_SENDER]

    dynamicMatchRule string

    动态组成员匹配规则，仅管理员或授权应用可访问，可修改（可选字段：在URL中增加$select=dynamicMatchRule查询参数后返回，如需多个字段使用英文逗号分隔）

    itemCountLimit number<int32>

    最大成员数限制，不超过100000，仅管理员或授权应用可修改（可选字段：在URL中增加$select=itemCountLimit查询参数后返回，如需多个字段使用英文逗号分隔）

    departmentId string

    归属部门（可选字段：在URL中增加$select=departmentId查询参数后返回，如需多个字段使用英文逗号分隔）

    isHidden boolean

    是否在通讯录显示此组，仅管理员或授权应用可访问，可修改（可选字段：在URL中增加$select=isHidden查询参数后返回，如需多个字段使用英文逗号分隔）

    ignoreAutoReplyOfMember boolean

    忽略成员的自动回复，仅管理员或授权应用可访问，可修改（可选字段：在URL中增加$select=ignoreAutoReplyOfMember查询参数后返回，如需多个字段使用英文逗号分隔）

    sendMessageToNewMember boolean

    是否发送通知信给新加入的成员，仅管理员或授权应用可访问，可修改（可选字段：在URL中增加$select=sendMessageToNewMember查询参数后返回，如需多个字段使用英文逗号分隔）

    requireApprovalWhenMemberLeaves boolean

    成员退出是否需要管理员审核，仅管理员或授权应用可访问，可修改（可选字段：在URL中增加$select=requireApprovalWhenMemberLeaves查询参数后返回，如需多个字段使用英文逗号分隔）

    memberOnlyVisibleToAdmin boolean

    成员是否仅管理员可见，仅管理员或授权应用可修改（可选字段：在URL中增加$select=memberOnlyVisibleToAdmin查询参数后返回，如需多个字段使用英文逗号分隔）

响应

无响应字段成功响应中没有已定义的字段。

错误

400Bad Request
401

访问未授权，请检查是否传递了正确的授权token

403

无API访问权限，请在域管的应用管理页面完成相关授权

404Not Found