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 地圖 Geocode 呼叫 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. 這表示您同時執行的指令碼太多,但不一定是同一個指令碼。與上述例外狀況類似,這通常發生在單一試算表中重複呼叫的自訂函式。