限制和配额可保护 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。 |