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 / 每波 | 9 KB / 每波 |
房源總儲存空間 | 每個房源儲存庫 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 / 呼叫 |
版本 | 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.
這表示一次執行過多指令碼,但不一定是相同的指令碼。與上述例外狀況類似,這通常發生在單一試算表中重複呼叫的自訂函式。