限制和配额可保护 Google 基础架构免受以不当方式使用 Groups Settings API 的自动化流程的影响。API 发出的过多请求可能是由无害的拼写错误或设计不当的系统（会发出不必要的 API 调用）引起的。无论原因如何，为了确保 Google Workspace 系统的整体健康，一旦来自特定来源的流量达到一定水平，就必须将其屏蔽。
API 请求失败
在极少数情况下，如果您的 API 请求失败，您的应用会收到 HTTP 状态代码响应。HTTP 状态代码 403 包含错误信息，指明超出了哪些 API 配额。该响应可让您的自定义应用检测错误并采取适当措施。
具有时效性的请求
如果您的请求需要在固定时间段内完成，请在 Java 或 C# 应用中并行发送请求或使用多个线程。例如，按月或其他时间段拆分请求。对于线程，请尝试从 10 个线程开始，每个请求一个线程。线程建议有利有弊，并非适用于所有 API 情况。如果请求数量过多，则会出现配额错误。
基于时间的错误
对于所有基于时间的错误（每个线程在 X 秒内最多执行 N 次操作），尤其是 503 状态代码错误，我们建议您的代码捕获异常，并使用指数退避算法，在等待一小段时间后重试失败的调用。对于一个线程，Groups Settings API 示例是等待 5 秒，然后重试失败的调用。如果请求成功，请针对其他线程重复此模式。
如果第二次请求不成功，您的应用应降低请求频率，直到调用成功。例如，将初始 5 秒延迟增加到 10 秒，然后再次重试失败的调用。此外，还要确定重试次数上限。例如，在应用向用户返回错误之前，使用不同的延迟时间重试请求 5-7 次。
配额
| API 配额类别 | 配额 |
|---|---|
| 每天查询次数 | 您每天最多可以执行 10 万次查询。如果您需要的容量超出此限制，可以从 Google Cloud 控制台的配额页面发送请求。 |
| 群组说明，大小上限 | 您最多可以输入 4,096 个字符的群组说明。 |
| 群组名称、大小上限 | 群组名称最多可包含 60 个字符。 |
defaultMessageDenyNotificationText |
通知文本最多可包含 10,000 个字符。如需详细了解 defaultMessageDenyNotificationText 属性，请参阅 API 参考文档。
|
maxMessageBytes |
默认消息大小上限为 1 MB。如需详细了解 maxMessageBytes 属性，请参阅 API 参考文档。
|
限制
| 限制类型 | 限制和指南 |
|---|---|
| 数据格式，默认 |
默认数据格式为 JSON。该 API 还支持 Atom 格式。JSON 和 Atom 数据格式都支持完整的读写功能。如需了解详情，请参阅 JSON 和 Atom 数据格式。 |
| Groups Settings API，启用 | 您必须先启用 Directory API，然后才能调用 Groups Settings API。如需了解详情，请参阅启用 Google Workspace API。 |