Apps Script 서비스에는 일부 기능에 대한 일일 할당량 및 한도가 있습니다. 할당량이나 한도를 초과하면 스크립트에서 예외가 발생하고 실행이 중지됩니다.
중요: 일부 기능에는 연결된 Google 제품의 추가 할당량이 있습니다. 제품의 Apps Script 서비스를 사용하면 관련된 모든 할당량 예약에 반영됩니다. 연결된 할당량에 도달하면 기능을 사용할 수 없게 됩니다.
현재 할당량
할당량은 일반 사용자 (예: gmail.com) 또는 G Suite 무료 버전 (단종됨) 계정 및 Google Workspace 계정의 사용자에 따라 다르게 설정됩니다.
아래 할당량을 사용해 스크립트를 테스트하세요. 모든 할당량은 언제든지 예고 없이 삭제, 축소 또는 변경될 수 있습니다.
| 특성 | 소비자 (예: 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초 |
| 동시 실행 | 30 / 사용자 | 30 / 사용자 |
| 이메일 첨부파일 | 250 / 메일 | 250 / 메일 |
| 최대 이메일 본문 크기 | 메일 200KB | 메일당 400KB |
| 메일당 이메일 수신자 | 50 / 메일 | 50 / 메일 |
| 이메일 첨부파일 전체의 최대 크기 | 메일당 25MB | 메일당 25MB |
| 속성 값 크기 | 9KB / 값 | 9KB / 값 |
| 속성 총 저장용량 | 500KB / 속성 저장소 | 500KB / 속성 저장소 |
| 트리거 | 사용자 / 스크립트 20명 | 사용자 / 스크립트 20명 |
| URL 가져오기 응답 크기 | 50MB / 회 | 50MB / 회 |
| URL 가져오기 헤더 | 100 / 호출 | 100 / 호출 |
| URL 가져오기 헤더 크기 | 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.이것은 한 번에 너무 많은 스크립트가 실행되고 있음을 나타내며, 반드시 같은 스크립트일 필요는 없습니다. 위의 예외와 마찬가지로 일반적으로 단일 스프레드시트에서 반복적으로 호출되는 커스텀 함수에서 발생합니다.