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