Google 服務的配額

Google Apps Script 服務設有每日配額,且部分功能有使用限制。如果超出配額或限制,指令碼會擲回例外狀況並停止執行。

部分功能有相關聯 Google 產品的額外配額。使用產品的 Apps Script 服務時,會計入所有相關聯的配額保留量。如果達到任何相關配額,功能就會無法使用。

目前的配額

個人帳戶 (例如 gmail.com) 和 Google Workspace 帳戶的使用者,配額設定層級不同。配額是依使用者計算,並在首次要求後 24 小時重設。

請參考下列配額,測試指令碼。所有配額隨時可能取消、減少或變更,恕不另行通知。

功能 個人帳戶 (例如 gmail.com) Google Workspace
帳戶
建立的日曆活動數 5,000 / 天 10,000 次 / 天
建立的聯絡人數 1,000 次 / 天 2,000 / 天
已建立文件 250 / 天 1,500 / 天
已轉換的檔案 2,000 / 天 4,000 次 / 天
每日電子郵件收件者人數 (例如使用 MailApp) 100* / 天 每天 1,500*
網域內每日電子郵件收件者人數 (例如使用 MailApp) 100* / 天 2,000 / 天
電子郵件讀取/寫入 (不含傳送) 20,000 次 / 天 50,000 / 天
群組讀取次數 2,000 / 天 10,000 次 / 天
JDBC 連線次數 10,000 次 / 天 50,000 / 天
JDBC 連線失敗次數 100 / 天 500 / 天
已建立簡報 250 / 天 1,500 / 天
屬性讀取/寫入 50,000 / 天 500,000 / 天
已建立投影片 250 / 天 1,500 / 天
建立的試算表數 250 / 天 3,200 / 天
觸發條件總執行階段 每天 90 分鐘 每天 6 小時
網址擷取呼叫次數 20,000 次 / 天 100,000 / 天
靜態地圖算繪 1,000 次 / 天 10,000 次 / 天
Google 地圖路線查詢 1,000 次 / 天 10,000 次 / 天
Google 地圖地理編碼呼叫 1,000 次 / 天 10,000 次 / 天
翻譯通話內容 5,000 / 天 20,000 次 / 天
Google 地圖海拔高度樣本查詢 1,000 次 / 天 10,000 次 / 天
Apps Script 專案 50 / 天 50 / 天

試用帳戶有額外限制。從免費試用帳戶轉換為付費訂閱後,若同時符合下列兩個條件,系統會自動增加您帳戶的限制:

  • 網域的累計費用達 $100 美元 (或等值金額) 以上。
  • 已達到此款項起付額度至少 60 天。

目前限制

請參考下列限制,測試指令碼。所有限制可能隨時取消、減少或變更,恕不另行通知。

功能 個人帳戶 (例如 gmail.com) Google Workspace
帳戶
指令碼執行階段 6 分鐘 / 執行 6 分鐘 / 執行
自訂函式執行階段 30 秒 / 執行 30 秒 / 執行
Google Workspace 外掛程式執行階段 30 秒 / 執行 30 秒* / 執行
每位使用者的並行執行數 30 / 使用者 30 / 使用者
每個指令碼的同步執行作業 1,000 1,000
電子郵件附加元件 每封 250 個 每封 250 個
電子郵件內文大小上限 200 KB / 訊息 400 KB / 訊息
每封電子郵件的收件人數 每封 50 個 每封 50 個
電子郵件總附件大小上限 25 MB / 訊息 25 MB / 訊息
屬性值大小 9 KB / val 9 KB / val
資源總儲存空間 每個資源商店 500 KB 每個資源商店 500 KB
觸發條件 20 個 / 使用者 / 指令碼 20 個 / 使用者 / 指令碼
網址擷取回應大小 50 MB / 通話 50 MB / 通話
URL Fetch 標頭 100 / 通話 100 / 通話
網址擷取標頭大小 8 KB / 通話 8 KB / 通話
網址擷取 POST 大小 50 MB / 通話 50 MB / 通話
網址擷取網址長度 每次通話 2 KB 每次通話 2 KB
版本 200 / 腳本 200 / 腳本

監控配額用量

如要監控指令碼的配額用量和執行健康狀態,請使用下列方法:

  • 電子郵件配額:使用 MailApp.getRemainingDailyQuota() 查看當天剩餘的電子郵件收件者人數。
  • 執行作業監控:使用 Apps Script 資訊主頁查看指令碼的執行記錄和健康狀態。「我的執行作業」頁面會顯示每項腳本執行作業的狀態 (例如 CompletedFailedRunning)。您可以篩選「狀態」Running 的執行作業,監控同時執行的次數。
  • Google Cloud 控制台:如果 Apps Script 專案使用標準 Google Cloud 專案,您可以在 Google Cloud 控制台中監控服務專屬配額和 API 使用量。

例外狀況訊息

如果指令碼達到配額或限制,系統會擲回例外狀況,並顯示類似下列訊息:

  • Limit exceeded: Email Attachments Per Message. 這表示指令碼超出「目前配額」或「目前限制」一節所列的其中一項配額或限制。
  • Service invoked too many times: Calendar. 這表示指令碼在一天內呼叫指定服務的次數過多。
  • Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls. 這表示指令碼在短時間內呼叫指定服務的次數過多。
  • Service using too much computer time for one day. 這表示指令碼已超過單日允許的總執行時間。如果指令碼是透過觸發條件執行,就最常發生這種情況,因為這類指令碼的每日限制比手動執行的指令碼低。
  • Script invoked too many times per second for this Google user account. 這表示指令碼在短時間內執行次數過多。如果單一試算表重複呼叫自訂函式,最常發生這種情況。如要避免這個錯誤,請編寫自訂函式程式碼,確保每個資料範圍只需要呼叫一次,詳情請參閱自訂函式指南
  • There are too many scripts running simultaneously for this Google user account. 這表示您同時執行的指令碼過多 (不一定是相同的指令碼)。與上述例外狀況相同,這種情況最常發生在單一試算表中重複呼叫的自訂函式。