用量限额和配额

限制和配额可保护 Google 基础架构免受自动流程以不当方式使用 Admin Settings API 所造成的影响。来自 API 的过多请求可能是由无害的拼写错误造成的,也可能是由设计效率低下的系统进行不必要的 API 调用造成的。无论出于何种原因,只要特定来源的流量达到一定水平,就禁止来自特定来源的流量,这对于 Google Workspace 系统的整体运行状况来说十分必要。这样可确保一个开发者的行为不会对更大的社区产生负面影响。

在极少数情况下,如果您的 API 请求失败,您会收到 HTTP 状态代码响应。状态代码 403 包含有关输入错误的错误信息,HTTP 状态代码 503 则包含错误信息,指示已超出哪些 API 配额。这些响应可让您的自定义应用检测这些错误并采取相应措施。

如果您的请求需要在固定时间段内完成,请并行发送请求,或在 Java 或 C# 应用中使用多个线程。例如,按月或按照其他时间段细分您的请求。对于线程,请尝试从 10 个线程开始,每个请求一个线程。请注意,线程建议需要进行权衡,并非适用于所有 API 情况。如果请求数量过多,就会发生配额错误。

对于所有基于时间的错误(每个线程最多 X 秒,尤其是 503 状态代码错误),我们建议您的代码捕获异常,并采用指数退避算法算法稍等片刻,然后重试失败的调用。一个线程的 Email Settings API 示例是等待 5 秒钟,然后重试失败的调用。如果请求成功,请为其他线程重复此模式。如果第二个请求不成功,您的应用应按请求的频率进行缩减,直到调用成功。例如,将初始 5 秒延迟增加至 10 秒,然后再次重试失败的调用。此外,还要确定重试限制。例如,在应用返回用户错误之前,以 5 次不同的延迟重试一个请求。

API 配额类别 配额
StreetView 身份验证令牌 有效期为 24 小时。错误为“401 token expired”。
生成公钥和私钥 通过身份提供方,使用 DSA 或 RSA 算法生成一组公钥和私钥。公钥采用 X.509 格式的证书。要详细了解基于 SAML 的单点登录密钥,请参阅为 Google Workspace 单点登录服务生成密钥和证书
徽标 帐号徽标图片文件可以采用 JPEG、PNG 或 GIF 格式。建议的尺寸为 143 x 59 像素,文件应小于 20 Kb。使用自定义徽标时,请务必遵守 Google 服务条款。避免使用 Google 徽标、Gmail 徽标或任何其他 Google 徽标。如需了解详情,请参阅徽标和着陆页政策
sso 白名单 sso 白名单是无类别域间路由 (CIDR) 格式的网络掩码 IP 地址。
其他类型的限制 限制和准则
MX 记录验证状态

默认的 MX 记录验证状态是“false”,表示 Google 系统最近未检查您的 MX 记录配置,或者您的 MX 记录未配置为指向 Google 系统。如果您更新了记录,并且验证状态仍然为 false,则表示您的 MX 记录更新尚未传播,或者记录中存在拼写错误。如需传播,我们建议您等待 MX 记录的生存时间 (TTL) 指定的时间,然后重试。

国家/地区代码 如果组织名称尚未自定义,则默认域名为主域名。如需了解组织名称字符,请参阅字符使用
creationTime 属性,日期和时间的数字表示形式 请参阅 ISO 8601,日期和时间的数字表示形式。
语言编码标记 请参阅 Google Mail 接受的 RFC 3066 语言标记
组织名称 如果组织名称尚未自定义,则默认域名为主域名。如需了解组织名称字符,请参阅字符使用