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 가져오기 헤더 크기 | 통화당 8KB | 통화당 8KB |
| URL 가져오기 게시 크기 | 호출당 50MB | 호출당 50MB |
| URL 가져오기 URL 길이 | 통화당 2KB | 통화당 2KB |
| 버전 | 200 / 스크립트 | 200 / 스크립트 |
예외 메시지
스크립트가 할당량 또는 제한에 도달하면 다음과 유사한 메시지와 함께 예외가 발생합니다.
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.이는 스크립트가 1일 동안 허용되는 총 실행 시간을 초과했음을 나타냅니다. 이 오류는 수동으로 실행되는 스크립트보다 일일 한도가 낮은 트리거에서 실행되는 스크립트에서 가장 흔히 발생합니다.Script invoked too many times per second for this Google user account.이는 짧은 시간 내에 스크립트가 너무 많이 실행되었음을 나타냅니다. 단일 스프레드시트에서 반복적으로 호출되는 맞춤 함수에서 가장 일반적으로 발생합니다. 이 오류를 방지하려면 맞춤 함수 가이드의 설명대로 데이터 범위당 한 번만 호출되도록 맞춤 함수를 코딩합니다.There are too many scripts running simultaneously for this Google user account.이는 동일한 스크립트가 아닐 수도 있지만 한 번에 너무 많은 스크립트가 실행됨을 나타냅니다. 위의 예외와 마찬가지로, 단일 스프레드시트에서 반복적으로 호출되는 맞춤 함수에서 가장 흔히 발생합니다.