调用Zoom API更新云录制可用提醒用户设置无响应不生效问题咨询

问题根因 #

该问题的核心根因为Zoom API v2中账号级与用户级设置的请求体结构不一致，属于官方文档容易被忽略的细节，常见触发原因如下：

• 核心触发点：账号级PATCH /accounts/{accountId}/settings接口的email_notification是顶层字段，而用户级PATCH /users/{userId}/settings接口的email_notification属于meeting字段的子属性。直接复用账号级的请求体结构时，API会将未识别的顶层email_notification字段直接忽略，因此无报错但配置不生效。
• 其他触发点：
  1. 目标用户所属的Zoom用户群组，已将「云录制可用邮件提醒」配置设为锁定状态。群组锁定的配置默认不允许API直接修改用户级参数，手动后台修改时会触发强制覆盖提示因此可以生效。
  2. 目标用户未被分配云录制使用许可，无云录制权限的用户该配置项默认不生效，API更新请求会被静默忽略。
  3. 自研平台调用接口时使用的API鉴权身份，仅拥有部分用户设置修改权限，被限制修改邮件通知类配置。

修复步骤 #

1. 优先调整用户级请求的请求体结构，正确格式如下：

{
  "meeting": {
    "email_notification": {
      "cloud_recording_available_reminder": true
    }
  }
}

2. 调整结构后仍不生效的，登录Zoom管理员后台，检查目标用户所属群组的设置，确认对应配置项未开启锁定。若已锁定可先解除群组锁定，或调用群组级设置修改接口更新对应配置。
3. 确认目标用户已分配云录制使用许可，无许可的用户需要先开通云录制权限再修改提醒配置。
4. 联系自研平台维护人员，确认调用Zoom API使用的鉴权账号拥有user:write:admin完整权限，未被限制修改用户邮件通知类配置。

内容的提问来源于stack exchange，提问作者Bominus5