限制和配额可保护 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 控制台中的配额页面 |
群组说明,大小上限 | 您最多可以输入 4,096 个字符的群组说明。 |
组名称、大小上限 | 群组名称最多可包含 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。 |