使用制限

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.batchModify 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