API 限制和配额

发送到 Google Photos Library API 的所有请求都会占用配额。我们实施这些限制是为了保护系统及其用户。

要访问该 API,您需要来自 Google 开发者项目的 OAuth 客户端凭据。如使用入门中所述,此项目必须启用 Library API。

如需详细了解如何正确使用此 API,请参阅使用限制政策

常规配额限制

Library API 请求的配额限制为每个项目每天 10,000 个请求。这包括所有 API 请求(例如上传、列出媒体和应用过滤条件),但不访问来自基准网址的媒体字节。

访问媒体字节的请求(通过从基准网址加载照片或视频)的配额限制为每个项目每天 75,000 个请求。

除了这些限制之外,还有其他配额可以保护我们系统的可靠性和完整性。如果您收到 429 错误,则表示您可能已经达到其中某项配额。如果您收到此类错误之一,请减少您在给定时间段内发出的请求数。如需了解详情,请参阅重试失败的请求指数退避算法

检查配额使用情况

要查看已使用多少可用配额,以及查看或更改项目的用量限额,请访问 Google API 控制台中的“配额”页面,然后选择 Photos Library API

超出配额限制

如果超出了向 Library API 发送的请求的配额,该 API 将返回错误代码 429 以及项目已超出配额的消息。如需了解详情,请参阅服务条款

申请更多配额

Google 相册合作伙伴计划面向需要提高配额限制的大型消费者应用。如果您认为自己的应用属于此类别,请申请加入合作伙伴计划

照片存储和画质

通过 API 上传到 Google 相册的所有媒体内容均以完整分辨率和原始画质存储。它们会计入用户的存储空间。