API 限制和配额

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

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

如需详细了解如何正确使用此 API，请参阅《Photos API User Data and Developer Policy》。

API 配额限制

每项 API 都有自己的配额，以保护我们系统的可靠性和完整性。如果您收到 429 错误，则很可能已达到以下某项配额。如果您收到这些错误之一，请减少在给定时间段内发出的请求数。如需了解详情，请参阅重试失败的请求和指数退避算法。

Photos Picker API 请求的配额限制为每个项目每分钟 10 万个请求。

访问媒体字节的请求（通过从基准网址加载照片或视频）的配额限制为每个项目每分钟 1,000,000 个请求。

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

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

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

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

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

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