Google 服務的配額

Apps Script 服務設有每日配額,部分功能也有限制。如果超出配額或限制,指令碼會擲回例外狀況,並停止執行。

重要事項:部分功能有額外配額,與其相關聯的 Google 產品也會有配額。使用產品的 Apps Script 服務時,會計入所有相關聯的配額預留量。如果達到任何相關配額,就無法使用該功能。

目前的配額

Google Workspace 帳戶、G Suite 免費版 (已停用) 帳戶和個人帳戶 (例如 gmail.com) 的使用者,配額設定在不同層級。配額以使用者為單位,並在第一次提出要求後的 24 小時重設。

請使用下列配額測試指令碼。所有配額隨時可能取消、減少或變更,恕不另行通知。

功能 消費者 (例如 gmail.com) 和
G Suite 免費版
(舊版)
Google Workspace
帳戶
建立的日曆活動數 5,000 / 天 10,000 / 天
建立的聯絡人數 1,000 次 / 天 2,000 / 天
已建立文件 250 / 天 1,500 / 天
已轉換的檔案 2,000 / 天 4,000 / 天
每日電子郵件收件者人數 (例如使用 MailApp) 100* / 天 每天 1,500*
網域內每日電子郵件收件者人數 (例如使用 MailApp) 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 / 通話
URL Fetch 標頭 100 / 通話 100 / 通話
網址擷取標頭大小 8 KB / 通話 8 KB / 通話
網址擷取 POST 大小 50 MB / 通話 50 MB / 通話
網址擷取網址長度 每次通話 2 KB 每次通話 2 KB
版本 200 / 腳本 200 / 腳本

監控配額用量

如要監控指令碼的配額用量和執行健康狀態,請使用下列方法:

  • 電子郵件配額:使用 MailApp.getRemainingDailyQuota() 查看當天剩餘的電子郵件收件者人數。
  • 執行作業監控:使用 Apps Script 資訊主頁查看指令碼的執行記錄和健康狀態。「我的執行作業」頁面會顯示每項腳本執行作業的狀態 (例如 CompletedFailedRunning)。您可以篩選「狀態」Running 的執行作業,監控同時執行的次數。
  • Google Cloud 控制台:如果 Apps Script 專案使用標準 Google Cloud 專案,您可以在 Google Cloud 控制台中監控服務專屬配額和 API 使用量。

例外狀況訊息

如果指令碼達到配額或限制,系統會擲回例外狀況,並顯示類似下列訊息:

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