跳到主要内容

批量更新共享账号成员

POST/v2/users/:id_or_email/sharedMembers/batchUpdate

批量更新指定共享账号的成员关系：

  • 已存在的成员会覆盖更新访问权限。
  • 不存在的成员会创建新的访问关系。 自助委托场景复用本接口：
  • 被委托人接受委托时，将自己对应成员的 SharedMember.status 更新为 APPROVED。
  • 被委托人拒绝委托时，将自己对应成员的 SharedMember.status 更新为 REJECTED。
  • 被委托人只能更新自己的成员条目，不能更新其他成员的条目。

Request​

Path parameters

    id_or_email stringrequired
    • id:
    • email:

请求体参数

    members object[]
    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