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