Google Apps Script サービスには、1 日の割り当てと一部の機能の制限があります。割り当てまたは制限を超えると、スクリプトで例外がスローされ、実行が停止します。
一部の機能には、関連付けられている Google プロダクトの追加の割り当てがあります。プロダクトの Apps Script サービスを使用すると、関連付けられているすべての割り当て予約にカウントされます。関連する割り当てのいずれかに達すると、機能は使用できなくなります。
現在の割り当て
割り当ては、一般ユーザー アカウント(gmail.com など)のユーザーと Google Workspace アカウントのユーザーで異なるレベルで設定されます。割り当てはユーザーごとに設定され、最初のリクエストから 24 時間後にリセットされます。
次の割り当てを使用して、スクリプトのテストに役立ててください。すべての割り当ては、予告なくいつでも削除、削減、変更される可能性があります。
| 機能 | 一般ユーザー向けアカウント(gmail.com など) | Google Workspace アカウント |
|---|---|---|
| カレンダーの予定の作成 | 5,000 / 日 | 10,000 件 / 日 |
| 連絡先の作成 | 1,000 / 日 | 2,000 / 日 |
| 作成したドキュメント | 1 日あたり 250 回 | 1,500 / 日 |
| 変換されたファイル | 2,000 / 日 | 4,000 / 日 |
| 1 日あたりのメール受信者数(MailApp など) | 1 日あたり 100 件* | 1,500* / 日 |
| ドメイン内の 1 日あたりのメール受信者数(MailApp など) | 1 日あたり 100 件* | 2,000 / 日 |
| メールの読み取り/書き込み(送信を除く) | 20,000 / 日 | 50,000 / 日 |
| グループの読み取り | 2,000 / 日 | 10,000 件 / 日 |
| JDBC 接続 | 10,000 件 / 日 | 50,000 / 日 |
| JDBC 接続の失敗 | 100 / 日 | 500 / 日 |
| プレゼンテーションの作成 | 1 日あたり 250 回 | 1,500 / 日 |
| プロパティの読み取り/書き込み | 50,000 / 日 | 500,000 / 日 |
| スライドが作成されました | 1 日あたり 250 回 | 1,500 / 日 |
| スプレッドシートの作成 | 1 日あたり 250 回 | 3,200 / 日 |
| トリガーの合計実行時間 | 90 分 / 日 | 6 時間 / 日 |
| URL 取得の呼び出し | 20,000 / 日 | 100,000 / 日 |
| 静的マップのレンダリング | 1,000 / 日 | 10,000 件 / 日 |
| Google マップのルートに関するクエリ | 1,000 / 日 | 10,000 件 / 日 |
| Google Map Geocode 呼び出し | 1,000 / 日 | 10,000 件 / 日 |
| 通話を翻訳する | 5,000 / 日 | 20,000 / 日 |
| Google マップの高度サンプルクエリ | 1,000 / 日 | 10,000 件 / 日 |
| Apps Script プロジェクト | 1 日あたり 50 回 | 1 日あたり 50 回 |
試用アカウントには追加の制限が適用されます。無料試用アカウントから有料サブスクリプションに変更した後に次の両方の条件を満たすと、アカウントの制限が自動的に引き上げられます。
- ドメインに対する請求額が累計 100 米ドル(またはご利用通貨での同等額)に達している。
- その基準額に達してから 60 日以上経過している。
現在の制限事項
スクリプトのテストには、次の上限を使用してください。すべての制限は、予告なくいつでも削除、削減、変更される可能性があります。
| 機能 | 一般ユーザー向けアカウント(gmail.com など) | 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 / ユーザー / スクリプト |
| URL 取得のレスポンス サイズ | 50 MB / 呼び出し | 50 MB / 呼び出し |
| URL 取得ヘッダー | 100 / 呼び出し | 100 / 呼び出し |
| URL Fetch Header のサイズ | 8 KB / 呼び出し | 8 KB / 呼び出し |
| URL Fetch の投稿サイズ | 50 MB / 呼び出し | 50 MB / 呼び出し |
| URL 取得 URL の長さ | 2 KB / 呼び出し | 2 KB / 呼び出し |
| バージョン | 200 / script | 200 / script |
割り当て使用量をモニタリングする
スクリプトの割り当て消費量と実行の健全性をモニタリングするには、次の方法を使用します。
- メールの割り当て:
MailApp.getRemainingDailyQuota()を使用して、その日の残りの時間に送信できるメールの宛先数を確認します。 - 実行のモニタリング: Apps Script ダッシュボードを使用して、スクリプトの実行履歴と健全性を確認します。[マイ実行] ページには、各スクリプト実行のステータス(
Completed、Failed、Runningなど)が表示されます。ステータスがRunningの実行をフィルタすることで、同時実行の数をモニタリングできます。 - Google Cloud コンソール: Apps Script プロジェクトで標準の Google Cloud プロジェクトを使用している場合は、Google Cloud コンソールでサービス固有の割り当てと API 使用状況をモニタリングできます。
例外メッセージ
スクリプトが割り当てまたは制限に達すると、次のようなメッセージを含む例外がスローされます。
Limit exceeded: Email Attachments Per Message.: スクリプトが、現在の割り当てまたは現在の制限事項のセクションに記載されている割り当てまたは制限事項のいずれかを超えたことを示します。Service invoked too many times: Calendar.: スクリプトが 1 日に指定されたサービスを呼び出した回数が多すぎることを示します。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.: スクリプトが 1 日の許容実行時間の合計を超えたことを示します。このエラーは、トリガーで実行されるスクリプトで最もよく発生します。トリガーで実行されるスクリプトには、手動で実行されるスクリプトよりも低い 1 日あたりの上限が設定されています。Script invoked too many times per second for this Google user account.これは、スクリプトが短期間に何度も実行されたことを示します。このエラーは、1 つのスプレッドシートで繰り返し呼び出されるカスタム関数で最もよく発生します。このエラーを回避するには、カスタム関数のガイドで説明されているように、カスタム関数をデータ範囲ごとに 1 回だけ呼び出すようにコーディングします。There are too many scripts running simultaneously for this Google user account.これは、必ずしも同じスクリプトではないものの、一度に実行されているスクリプトが多すぎることを示しています。前の例外と同様に、この例外は、1 つのスプレッドシートで繰り返し呼び出されるカスタム関数で最もよく発生します。