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 / 메시지 |
| 속성 값 크기 | 9 KB / val | 9 KB / val |
| 속성 총 저장용량 | 500KB / 속성 스토어 | 500KB / 속성 스토어 |
| 트리거 | 20 / 사용자 / 스크립트 | 20 / 사용자 / 스크립트 |
| URL 가져오기 응답 크기 | 50MB / 호출 | 50MB / 호출 |
| URL 가져오기 헤더 | 100 / 호출 | 100 / 호출 |
| URL 가져오기 헤더 크기 | 8KB / 호출 | 8KB / 호출 |
| URL 가져오기 POST 크기 | 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.스크립트가 하루에 허용되는 총 실행 시간을 초과했음을 나타냅니다. 이 오류는 일반적으로 트리거에서 실행되는 스크립트에서 발생하며, 이러한 스크립트의 일일 한도는 수동으로 실행되는 스크립트보다 낮습니다.Script invoked too many times per second for this Google user account.이는 스크립트가 짧은 기간에 너무 많이 실행되었음을 나타냅니다. 이 문제는 단일 스프레드시트에서 반복적으로 호출되는 맞춤 함수에서 가장 흔하게 발생합니다. 이 오류를 방지하려면 맞춤 함수 가이드에 설명된 대로 데이터 범위당 한 번만 호출하면 되도록 맞춤 함수를 코딩하세요.There are too many scripts running simultaneously for this Google user account.이는 동일한 스크립트가 아니더라도 한 번에 실행되는 스크립트가 너무 많음을 나타냅니다. 위의 예외와 마찬가지로 이 오류는 단일 스프레드시트에서 반복적으로 호출되는 맞춤 함수에서 가장 흔하게 발생합니다.