本文介绍了 创建 或 修改 周期性会议规则的 recurringRule 对象体的各个字段及其用途。recurringRule 对象体用于定义会议的重复模式、频率和结束条件。使用时请确保所有必填字段都已正确设置，以保证会议规则的正确执行。

字段说明

字段名称	类型	说明	可选值／备注
type	Integer	重复类型。	1：不重复（等同于预约非周期性会议）此时您无需设置 customizedFrequency 参数，endRule 可以省略或设置次数为 1。 2：每天。 3：每工作日。 4：每周。 5：每两周。 6：每月的今天。 7：自定义。
- customizedFrequency	CustomizedFrequency	自定义频率设置。	当 type=7 时，该配置生效，且必须填写。
stepSize	Integer	重复间隔步长。	表示每隔多少个单位重复一次。
stepUnit	Integer	重复间隔单位。	daysOfWeek 和 daysOfMonth 字段只在相应的 stepUnit 值下生效。 1：天。 2：周。 3：月（指定天数）。
daysOfWeek	List<Integer>	每周重复的星期几，可多选。	1：周日。 2：周一。 3：周二。 4：周三。 5：周四。 6：周五。 7：周六。
daysOfMonth	List<Integer>	每月重复的日期，可多选。	1-31在设置月重复时，请注意选择合适的日期，避免出现无效日期（如 2 月 30 日）。
- endRule	EndRule	结束规则设置。	必须指定 endRule，以避免无限循环的会议。
type	Integer	结束类型。	1：结束日期。 2：结束次数。
times	Integer	结束次数。	当 type=2 时使用。
date	String	结束日期。	当 type=1 时使用，日期格式应严格遵循 yyyy/mm/dd。

设置示例

示例一：每周一三五的会议

JSON{
  "type": 7, // 类型为自定义（7）。
  "customizedFrequency": {
    "stepSize": 1,
    "stepUnit": 2, // 每（1）周重复。
    "daysOfWeek": [2, 4, 6] // 在周一（2）、周三（4）、周五（6）举行。
  },
  "endRule": {
    "type": 2,
    "times": 10 // 重复 10 次后结束。
  }
}

示例二：每月 1 日和 15 日的会议并持续到年底

JSON{
  "type": 7, // 类型为自定义（7）。
  "customizedFrequency": {
    "stepSize": 1,
    "stepUnit": 3, // 每（1）月重复。
    "daysOfMonth": [1, 15] // 在每月的 1 日和 15 日举行。
  },
  "endRule": {
    "type": 1,
    "date": "2024/12/31" // 到 2024 年 12 月 31 日结束。
  }
}

示例三：每两周（的今天）一次的会议

JSON{
  "type": 5, // 类型为每两周（的今天）。
  "endRule": {
    "type": 2,
    "times": 6 // 重复 6 次后结束。
  }
}

高级用法

组合使用

可以组合使用不同的设置来创建复杂的重复模式。例如，如果您想设置每两周的周一和周三举行会议，直到 2024 年底，可以这样设置：

JSON{
  "type": 7, // 类型为自定义（7）。
  "customizedFrequency": {
    "stepSize": 2,
    "stepUnit": 2,
    "daysOfWeek": [2, 4]
  },
  "endRule": {
    "type": 1,
    "date": "2024/12/31"
  }
}

灵活调整

您可以根据实际需求灵活调整各个参数。例如，如果您想要设置每月的最后一个工作日举行会议，可以这样设置：

JSON{
  "type": 7, // 类型为自定义（7）。
  "customizedFrequency": {
    "stepSize": 1,
    "stepUnit": 4 // 表示每月指定为当天所在的工作日，实现了每月最后一个工作日的会议设置。
  },
  "endRule": {
    "type": 2,
    "times": 12
  }
}

常见问题

如何设置不重复的单次会议？

将 type 设置为 1，无需设置 customizedFrequency，endRule 可以省略或设置次数为 1。

如何设置无限重复的会议？

出于管理和性能考虑，会议拥有最大重复上限，每天、每个工作日、每周最大支持200场子会议，每两周、每月最大支持50场子会议。