API 限制和配额

发送到 Google Photos API 的所有请求都会计入配额。应用这些限制旨在保护系统及其用户。

访问该 API 需要 Google 开发者项目的 OAuth 客户端凭据。此项目必须启用 Google 相册 API,如配置应用中所述。

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

常规配额限制

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

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

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

检查配额使用情况

如需查看已使用多少可用配额,以及查看或更改项目的使用限制,请访问 Google API 控制台中的“配额”页面,然后选择 Google 相册选择器 APIGoogle 相册库 API

超出配额限制

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

申请更多配额

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

照片的存储和画质

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