用量限制和配額

設定限制及配額後,Google 基礎架構即不會因不當使用 Admin Settings API 而自動執行。來自 API 的過度要求可能來自無害的錯字,或是由設計不良的系統發出,不需要進行 API 呼叫。不過,無論原因為何,當特定來源的流量達到特定等級時,就要封鎖 Google Workspace 系統的整體健康狀態。這麼做可以確保單一開發人員的動作不會直接影響較廣大的社群。

在極少數的 API 要求失敗的情況下,您會收到 HTTP 狀態碼回應。狀態碼 403 包含錯誤輸入錯誤資訊,而 HTTP 狀態碼 503 的錯誤資訊,指出已超過 API 配額。這些回應可讓自訂應用程式偵測這些錯誤並採取適當行動。

如果要求必須在固定時間內完成,請同時傳送要求,或在 Java 或 C# 應用程式中使用多個執行緒。例如按月份或其他時間範圍細分要求。如果是執行緒,請先從 10 個執行緒開始,每個要求一個執行緒。請注意,執行緒建議有取捨,不適用於所有 API 情況。如果要求數量過高,就會發生配額錯誤。

對於所有以時間為準的錯誤 (每個執行緒 X 秒最多 N 個項目),尤其是 503 狀態碼錯誤,我們建議您將程式碼擷取到例外狀況,然後利用指數輪詢演算法等待一段時間,然後重試失敗的呼叫。其中一個執行緒的 Email Settings API 範例是等候 5 秒,然後重試失敗的呼叫。如果要求成功,請為其他執行緒重複使用這個模式。如果第二個請求不成功,您的應用程式應按照要求頻率調整,直到呼叫成功為止。例如,將一開始的延遲 5 秒增加到 10 秒,然後再次重試失敗的呼叫。此外,請決定重試上限。舉例來說,在應用程式傳回錯誤給使用者之前,重試 5 到 7 次,並傳回不同的延遲時間。

API 配額類別 配額
ClientLogin 驗證權杖 效期為 24 小時。錯誤訊息為「401 Token 過期」。
產生公開與私密金鑰 透過識別資訊提供者,使用 DSA 或 RSA 演算法產生一組公開和私密金鑰。公開金鑰的格式為 X.509。如要進一步瞭解 SAML 式單一登入簽署金鑰,請參閱產生 Google Workspace 單一登入服務所需的金鑰和憑證
Logo 帳戶的標誌圖片檔案可以是 JPEG、PNG 或 GIF 格式。建議大小為 143 x 59 像素,且檔案必須小於 20Kb。使用自訂標誌時,請務必遵守 Google《服務條款》。此外,也請避免使用 Google 標誌、Gmail 標誌或任何其他 Google 標誌。詳情請參閱標誌和到達網頁政策
關聯許可清單 sso 白 是採用無類別跨網域路由 (CIDR) 格式的網路遮罩 IP 位址。
其他限制類型 限制和規範
MX 紀錄驗證狀態

預設的 MX 紀錄驗證狀態為「false」,這表示 Google 系統最近並未檢查您的 MX 紀錄設定,或者您的 MX 紀錄並未設定為指向 Google 系統。如果您已更新記錄,且驗證狀態仍為「否」,可能表示你的 MX 記錄更新尚未傳播,或是記錄中有錯字。如需設定,建議您等待 MX 記錄的存留時間 (TTL) 定義的時間長度,然後再試一次。

國家/地區代碼 如果機構名稱尚未自訂,則預設值為您的主網域名稱。如需機構名稱字元的相關資訊,請參閱字元使用規範
creationTime 屬性,以數字表示日期和時間 請參閱 ISO 8601,以數字表示日期和時間。
語言編碼標記 請參閱 Google Mail 接受的 RFC 3066 語言標記
機構名稱 如果機構名稱尚未自訂,則預設值為您的主網域名稱。如需機構名稱字元的相關資訊,請參閱字元使用規範