发送到 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 相册的所有媒体内容均以完整分辨率和原始画质存储。它们会计入用户的存储空间。