사용량 한도
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Gmail API에는 API 메서드를 호출할 수 있는 비율을 제한하는 사용량 한도가 적용됩니다. 한도는 Gmail 리소스 사용량을 나타내는 추상 측정 단위인 할당량 단위 로 정의됩니다. 프로젝트별 사용량 한도와 사용자별 사용량 한도라는 두 가지 사용량 한도가 동시에 적용됩니다. 다음 표에는 이러한 사용량 한도가 자세히 나와 있습니다.
참고: 한도 오류 처리에 대한 자세한 내용은 오류 해결 을 참고하세요.
메서드별 할당량 사용량
요청에서 사용한 할당량 단위 수는 호출된 메서드에 따라 다릅니다. 다음 표에는 메서드별 할당량 단위 사용량이 나와 있습니다.
메서드
할당량 단위
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
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Usage limits\n\nThe Gmail API is subject to usage limits which restrict the rate at which\nmethods of the API can be called. Limits are defined in terms of [quota\nunits](#per-method_quota_usage), an abstract unit of measurement representing\nGmail resource usage. There are two usage limits which are applied\nsimultaneously: a per project usage limit and a per user usage limit. The\nfollowing table details these usage limits:\n\n| Usage limit type | Limit | Exceeded reason |\n|------------------------|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| Per project rate limit | 1,200,000 quota units per minute | [rateLimitExceeded](https://developers.google.com/workspace/gmail/api/guides/handle-errors#resolve_a_403_error_rate_limit_exceeded) |\n| Per user rate limit | 15,000 quota units per user per minute | [userRateLimitExceeded](https://developers.google.com/workspace/gmail/api/guides/handle-errors#resolve_a_403_error_user_rate_limit_exceeded) |\n\n| **Note:** For information on handling limit errors, refer to [Resolve\n| errors](/workspace/gmail/api/guides/handle-errors).\n\nPer-method quota usage\n----------------------\n\nThe number of quota units consumed by a request varies depending on the method\ncalled. The following table outlines the per-method quota unit usage:\n\n| Method | Quota Units |\n|---------------------------------------|-------------|\n| `drafts.create` | 10 |\n| `drafts.delete` | 10 |\n| `drafts.get` | 5 |\n| `drafts.list` | 5 |\n| `drafts.send` | 100 |\n| `drafts.update` | 15 |\n| `getProfile` | 1 |\n| `history.list` | 2 |\n| `labels.create` | 5 |\n| `labels.delete` | 5 |\n| `labels.get` | 1 |\n| `labels.list` | 1 |\n| `labels.update` | 5 |\n| `messages.attachments.get` | 5 |\n| `messages.batchDelete` | 50 |\n| `messages.batchModify` | 50 |\n| `messages.delete` | 10 |\n| `messages.get` | 5 |\n| `messages.import` | 25 |\n| `messages.insert` | 25 |\n| `messages.list` | 5 |\n| `messages.modify` | 5 |\n| `messages.send` | 100 |\n| `messages.trash` | 5 |\n| `messages.untrash` | 5 |\n| `settings.delegates.create` | 100 |\n| `settings.delegates.delete` | 5 |\n| `settings.delegates.get` | 1 |\n| `settings.delegates.list` | 1 |\n| `settings.filters.create` | 5 |\n| `settings.filters.delete` | 5 |\n| `settings.filters.get` | 1 |\n| `settings.filters.list` | 1 |\n| `settings.forwardingAddresses.create` | 100 |\n| `settings.forwardingAddresses.delete` | 5 |\n| `settings.forwardingAddresses.get` | 1 |\n| `settings.forwardingAddresses.list` | 1 |\n| `settings.getAutoForwarding` | 1 |\n| `settings.getImap` | 1 |\n| `settings.getPop` | 1 |\n| `settings.getVacation` | 1 |\n| `settings.sendAs.create` | 100 |\n| `settings.sendAs.delete` | 5 |\n| `settings.sendAs.get` | 1 |\n| `settings.sendAs.list` | 1 |\n| `settings.sendAs.update` | 100 |\n| `settings.sendAs.verify` | 100 |\n| `settings.updateAutoForwarding` | 5 |\n| `settings.updateImap` | 5 |\n| `settings.updatePop` | 100 |\n| `settings.updateVacation` | 5 |\n| `stop` | 50 |\n| `threads.delete` | 20 |\n| `threads.get` | 10 |\n| `threads.list` | 10 |\n| `threads.modify` | 10 |\n| `threads.trash` | 10 |\n| `threads.untrash` | 10 |\n| `watch` | 100 |"]]