Apps Script 서비스는 일부 기능에 일일 할당량 및 한도가 적용됩니다. 할당량이나 한도를 초과하면 스크립트에서 예외가 발생하고 실행이 중지됩니다.
중요: 일부 기능에는 연결된 Google 제품의 추가 할당량이 있습니다. 제품의 Apps Script 서비스를 사용하면 관련된 모든 할당량 예약에 포함됩니다. 관련 할당량에 도달하면 기능을 사용할 수 없게 됩니다.
현재 할당량
할당량은 일반 사용자 (예: gmail.com) 또는 G Suite 무료 버전 (지원 중단된) 계정 및 Google Workspace 계정 사용자에 대해 서로 다른 수준에서 설정됩니다. 할당량은 사용자별로 적용되며 첫 번째 요청 후 24시간이 지나면 재설정됩니다.
아래 할당량을 사용하면 스크립트를 테스트하는 데 도움이 됩니다. 모든 할당량은 예고 없이 언제든지 제거, 감소 또는 변경될 수 있습니다.
| 특성 | 일반 사용자 (예: gmail.com) 및 G Suite 무료 버전 (기존) |
Google Workspace 계정 |
|---|---|---|
| 생성된 캘린더 일정 수 | 5,000 / 일 | 10,000 / 일 |
| 생성된 주소록 수 | 1,000 / 일 | 2,000 / 일 |
| 만든 문서 | 250 / 일 | 1,500 / 일 |
| 변환된 파일 | 2,000 / 일 | 4,000 / 일 |
| 일일 이메일 수신자 수 | 100* / 일 | 1,500* / 일 |
| 도메인 내 일일 이메일 수신자 수 | 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시간 / 일 |
| URL 가져오기 호출 수 | 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 / 메일 |
| 최대 이메일 본문 크기 | 메일 하나당 200KB | 메일 하나당 400KB |
| 메일당 이메일 수신자 수 | 메일 하나당 50개 | 메일 하나당 50개 |
| 이메일 첨부파일 전체의 최대 크기 | 메일 하나당 25MB | 메일 하나당 25MB |
| 속성 값 크기 | 9KB / 밸런스 | 9KB / 밸런스 |
| 속성 총 저장용량 | 500KB / 숙박 시설 스토어 | 500KB / 숙박 시설 스토어 |
| 트리거 | 사용자/스크립트당 20개 | 사용자/스크립트당 20개 |
| URL 가져오기 응답 크기 | 호출당 50MB | 호출당 50MB |
| URL 가져오기 헤더 | 호출당 100명 | 호출당 100명 |
| URL Fetch 헤더 크기 | 호출당 8KB | 호출당 8KB |
| URL 가져오기 POST 크기 | 호출당 50MB | 호출당 50MB |
| URL 가져오기 URL 길이 | 통화당 2KB | 통화당 2KB |
예외 메시지
스크립트가 할당량이나 제한에 도달하면 다음과 유사한 메시지와 함께 예외가 발생합니다.
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.이 오류는 반드시 동일한 스크립트는 아니지만 한 번에 실행 중인 스크립트가 너무 많음을 나타냅니다. 위의 예외와 마찬가지로, 이 문제는 단일 스프레드시트에서 반복적으로 호출되는 맞춤 함수에서 가장 일반적으로 발생합니다.