API 限制與配額

傳送至 Google 相簿 API 的所有要求都會計入配額。我們設定這些限制,是為了保護系統和使用者。

如要存取 API,必須使用 Google 開發人員專案的 OAuth 用戶端憑證。這個專案必須啟用相片 API,如「設定應用程式」一文所述。

如要進一步瞭解如何適當使用這項 API,請參閱《Photos API 使用者資料與開發人員政策》。

API 配額限制

為確保系統的可靠性和完整性,每個 API 都有各自的配額。如果收到 429 錯誤,表示您可能已達到其中一項配額。如果收到其中一項錯誤,請減少在特定時間內提出的要求數量。詳情請參閱重試失敗要求指數輪詢

Picker API 配額限制

每個專案每分鐘最多可向 Photos Picker API 發出 100,000 項要求。

存取媒體位元組的要求配額限制 (透過從基本網址載入相片或影片) 為每項專案每分鐘 1,000,000 項要求。

Library API 配額限制

對 Library API 的要求配額上限為每個專案每天 10,000 次。包括所有 API 要求,例如上傳、列出媒體和套用篩選器,但不包括從基本網址存取媒體位元組。

存取媒體位元組的要求配額上限 (透過從基本網址載入相片或影片) 為每個專案每天 75,000 項要求。

查看配額用量

如要查看已使用的可用配額,以及查看或變更專案的使用限制,請前往 Google API 控制台的配額頁面,然後選取「Photos Picker API」或「Photos Library API」

超出配額限制

如果超出相片 API 的要求配額,API 會傳回錯誤代碼 429,以及專案超出配額的訊息。詳情請參閱《服務條款》。

申請更多配額

Google 相簿合作夥伴計畫適用於需要提高配額限制的大型消費者應用程式。如果你認為自己的應用程式屬於這個類別,請表達對合作夥伴計畫的興趣

相片儲存空間和畫質

透過 API 上傳至 Google 相簿的所有媒體項目,都會以原始畫質的完整解析度儲存。這些項目會計入使用者的儲存空間。