Google 服務的配額

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. 這表示一次執行的指令碼過多,但不一定是同一指令碼。和上述例外狀況一樣,這種情況最常發生在單一試算表中重複呼叫的自訂函式。