Gmail API には使用量の上限があり、API のメソッドを呼び出せる頻度が制限されます。上限は、Gmail リソースの使用量を表す抽象的な測定単位である割り当て単位で定義されます。プロジェクトごとの使用量の上限とユーザーごとの使用量の上限の 2 つの使用量の上限が同時に適用されます。次の表に、これらの使用上限の詳細を示します。
| 使用量上限の種類 | 上限 | 超過の理由 |
|---|---|---|
| プロジェクトごとのレート制限 | 1 分あたり 1,200,000 の割り当てユニット | rateLimitExceeded |
| ユーザーごとのレート制限 | 1 ユーザー、1 分あたり 15,000 の割り当てユニット | userRateLimitExceeded |
メソッドごとの割り当て使用量
リクエストで消費される割り当てユニットの数は、呼び出されるメソッドによって異なります。次の表に、メソッドごとの割り当て単位の使用量を示します。
| メソッド | 割り当てユニット |
|---|---|
drafts.create |
10 |
drafts.delete |
10 |
drafts.get |
5 |
drafts.list |
5 |
drafts.send |
100 |
drafts.update |
15 |
getProfile |
1 |
history.list |
2 |
labels.create |
5 |
labels.delete |
5 |
labels.get |
1 |
labels.list |
1 |
labels.update |
5 |
messages.attachments.get |
5 |
messages.batchDelete |
50 |
messages.delete |
10 |
messages.get |
5 |
messages.import |
25 |
messages.insert |
25 |
messages.list |
5 |
messages.modify |
5 |
messages.send |
100 |
messages.trash |
5 |
messages.untrash |
5 |
settings.delegates.create |
100 |
settings.delegates.delete |
5 |
settings.delegates.get |
1 |
settings.delegates.list |
1 |
settings.filters.create |
5 |
settings.filters.delete |
5 |
settings.filters.get |
1 |
settings.filters.list |
1 |
settings.forwardingAddresses.create |
100 |
settings.forwardingAddresses.delete |
5 |
settings.forwardingAddresses.get |
1 |
settings.forwardingAddresses.list |
1 |
settings.getAutoForwarding |
1 |
settings.getImap |
1 |
settings.getPop |
1 |
settings.getVacation |
1 |
settings.sendAs.create |
100 |
settings.sendAs.delete |
5 |
settings.sendAs.get |
1 |
settings.sendAs.list |
1 |
settings.sendAs.update |
100 |
settings.sendAs.verify |
100 |
settings.updateAutoForwarding |
5 |
settings.updateImap |
5 |
settings.updatePop |
100 |
settings.updateVacation |
5 |
stop |
50 |
threads.delete |
20 |
threads.get |
10 |
threads.list |
10 |
threads.modify |
10 |
threads.trash |
10 |
threads.untrash |
10 |
watch |
100 |