跳到主要内容

批量删除共享账号成员

POST/v2/users/:id_or_email/sharedMembers/batchDelete

从指定共享账号中批量删除成员及其访问关系。 自助委托场景复用本接口：

  • 委托人/账号所有者可删除任意委托成员。
  • 被委托人仅可删除自己对应的成员条目，以解除自身的委托关系。

Request​

Path parameters

    id_or_email stringrequired
    • id:
    • email:

请求体参数

    members object[]

    成员 (type + value)

    sendMimeType object
    email boolean
    calendar boolean
    type enum

    成员类型

    • USER:
    • DEPARTMENT:
    • GROUP:

    Possible values: [USER, DEPARTMENT, GROUP]

    value string

    成员值- type 为 USER 时，value 为用户 email- type 为 DEPARTMENT 时，value 为部门 id- type 为 GROUP 时，value 为群组 email

    isBlocked boolean

    该成员是否 blocked

    name string

    成员的名字，只读属性

    relationships enum[]

    共享关系如 LOGIN + SEND_AS / SEND_ON_BEHALF

    Possible values: [LOGIN, SEND_AS, SEND_ON_BEHALF]

    status enum

    共享成员审批状态，用于自助委托场景。老数据或老调用方未传该字段时，业务逻辑应默认为 APPROVED，以保持线上兼容。自助委托状态流转：委托人/账号所有者发起委托（PENDING）→ 被委托人接受（APPROVED）或拒绝（REJECTED）。

    • PENDING: 待接受，委托人/账号所有者发起委托后，被委托人尚未处理
    • APPROVED: 已接受，被委托人同意委托，委托生效
    • REJECTED: 已拒绝，被委托人拒绝委托
    • EXPIRED: 已过期（预留枚举，本期不实现，不会被设置）

    Possible values: [PENDING, APPROVED, REJECTED, EXPIRED]

响应

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

错误

400Bad Request
401

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

403

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

404Not Found