Apps Script 服務對部分功能設有每日配額和限制。如果超出配額或限制,指令碼會擲回例外狀況並停止執行作業。
重要事項:某些功能在相關聯的 Google 產品中另有額外配額。使用產品的 Apps Script 服務都會計入所有相關配額保留額。如果達到任何相關的配額,該功能就會無法使用。
目前的配額
針對消費者 (例如 gmail.com)、G Suite 免費版 (已終止) 帳戶和 Google Workspace 帳戶,系統會分別設定不同層級的配額。配額為每位使用者,且會在首次要求後的 24 小時內重設。
請參考下列配額測試指令碼。所有配額均可能隨時刪除、縮減或變更,恕不另行通知。
功能 | 消費者 (例如 gmail.com) 和 G Suite 免費版 (舊版) |
Google Workspace 帳戶 |
---|---|---|
建立的日曆活動數 | 每天 5,000 次 | 10,000 / 天 |
建立的聯絡人數 | 1,000 / 天 | 每天 2,000 次 |
已建立文件 | 250 / 天 | 每天 1,500 次 |
已轉換的檔案 | 每天 2,000 次 | 每天 4,000 次 |
每日電子郵件收件者數 | 100* / 天 | 每天 1,500* |
網域內每日電子郵件收件者數 | 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 個 |
目前限制
請運用下列限制來測試指令碼。所有限制均可能隨時刪除、減少或變更,恕不另行通知。
功能 | 消費者 (例如 gmail.com) 和 G Suite 免費版 (舊版) |
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 |
網址擷取標頭 | 100 次 / 呼叫 | 100 次 / 呼叫 |
網址擷取標頭大小 | 每次呼叫 8 KB | 每次呼叫 8 KB |
網址擷取 POST 大小 | 每次呼叫 50 MB | 每次呼叫 50 MB |
網址擷取網址長度 | 每呼叫 2 KB | 每呼叫 2 KB |
Versions | 200 / 字集 | 200 / 字集 |
例外狀況訊息
如果指令碼達到配額或限制,就會擲回例外狀況,並會顯示類似以下的訊息:
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.
這表示一次執行的指令碼過多,但不一定是同一指令碼。和上述例外狀況一樣,這種情況最常發生在單一試算表中重複呼叫的自訂函式。