Google Sheets API 是一项共享服务，我们会应用配额和限制，以保护 Google Workspace 系统的整体性能，确保所有用户都能获得良好的体验。
配额限制
虽然 Sheets API 对 API 请求没有硬性的大小限制，但用户可能会遇到由 Google 表格无法控制的不同处理组件带来的限制。为加快请求速度，建议将载荷大小限制在 2 MB 以内。
Sheets API 具有每分钟配额，并且每分钟都会重新填充。例如，每个项目每分钟的读取请求限额为 300。如果您的应用在一分钟内发送 350 个请求，则超出配额的额外 50 个请求会生成 429: Too many requests HTTP 状态代码响应。如果发生这种情况，您应使用指数退避算法。1 分钟后，您可以再次执行请求。
下表详细列出了请求限制：
| 配额 | |||||
|---|---|---|---|---|---|
| 读请求次数 |
|
||||
| 写请求次数 |
|
||||
如需详细了解文件限制，请参阅可存储在 Google 云端硬盘中的文件。
行为和限制
在使用 ((sheets_api_short)) 时，请注意以下会影响配额的行为和限制：
读取请求是指对任何从电子表格中检索数据的方法（例如
get或search）的调用。写入请求是指对任何可更改电子表格的方法的调用，例如update、clear或copyTo。用户可以同时提交多个请求，只要这些请求不超过配额限制即可。每个批处理请求（包括任何子请求）都算作一次 API 请求，计入您的用量限额。
所有 Google 表格请求均以原子方式应用。也就是说，如果任何请求无效，则整个更新都会失败，并且不会应用任何（可能相互依赖的）更改。
处理单个 API 请求的时间上限。如果 Google 表格处理请求的时间超过 180 秒，该请求会返回超时错误。
只要您不超过每分钟配额，每天可以发出的请求数量就没有限制。
解决基于时间的配额错误
对于所有基于时间的错误（每 X 分钟最多 N 个请求），我们建议您的代码捕获异常并使用截断的指数退避，以确保设备不会产生过大的负载。
指数退避算法是网络应用的标准错误处理策略。指数退避算法以指数方式重试请求（不断增加各次请求之间的等待时间，直到达到最大退避时间）。如果请求仍然失败，请务必逐渐增加请求之间的延迟时间，直到请求成功为止。
示例算法
指数退避算法以指数方式重试请求（不断增加各次重试之间的等待时间，直到达到最大退避时间）。例如：
- 向 Google Sheets API 发出请求。
- 如果请求失败，请等待 1 +
random_number_milliseconds秒后再重试请求。 - 如果请求失败，请等待 2 +
random_number_milliseconds秒后再重试请求。 - 如果请求失败，请等待 4 +
random_number_milliseconds秒后再重试请求。 - 依此类推，等待时间上限为
maximum_backoff。 - 继续等待并重试，直至达到重试次数上限，但不会增加重试之间的等待时间。
其中：
- 等待时间为
min(((2^n)+random_number_milliseconds), maximum_backoff)，其中，n会在每次迭代（请求）后增加 1。 random_number_milliseconds是小于或等于 1,000 的毫秒数（随机值）。这有助于避免出现以下情况：许多客户端在某些情况下全部同步进行处理并同时执行重试操作，导致同步发送每一波请求。每次重试请求后，系统都会重新计算random_number_milliseconds值。maximum_backoff通常为 32 或 64 秒。适当的值取决于用例。
客户端在达到 maximum_backoff 时间后可以继续重试。
此后执行的重试不需要继续增加退避时间。例如，如果客户端使用的 maximum_backoff 时间为 64 秒，则在达到此值后，客户端可以每 64 秒重试一次。到了特定时间点后，客户端应停止无限重试。
重试之间的等待时间和重试次数取决于您的用例和网络条件。
价格
Google Sheets API 可完全免费使用。超出配额请求限制不会产生额外费用，也不会向您的账号收取费用。
申请增加配额
根据项目的资源用量，您可能需要申请调整配额。服务账号的 API 调用被视为使用单个账号。我们无法保证您的调整配额请求一定会得到批准。如果配额调整请求会大幅增加配额值，则可能需要更长时间才能获得批准。
并非所有项目的配额都完全相同。随着您对 Google Cloud 的使用量逐步增加，您可能需要增加配额值。如果您预计用量即将显著增加，可以在 Google Cloud 控制台的“配额”页面中主动申请调整配额。
如需了解详情，请参阅以下资源：