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 / msg | 50 / msg |
| 이메일 첨부파일 전체의 최대 크기 | 25MB / 메시지 | 25MB / 메시지 |
| 속성 값 크기 | 9 KB / val | 9 KB / val |
| 속성 총 저장용량 | 속성 스토어당 500KB | 속성 스토어당 500KB |
| 트리거 | 사용자/스크립트당 20개 | 사용자/스크립트당 20개 |
| URL Fetch 응답 크기 | 통화당 50MB | 통화당 50MB |
| URL 가져오기 헤더 | 100 / 통화 | 100 / 통화 |
| URL Fetch header 크기 | 8KB / 호출 | 8KB / 호출 |
| URL Fetch 게시 크기 | 통화당 50MB | 통화당 50MB |
| URL Fetch 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.동일한 스크립트가 아닐 수도 있지만 한 번에 실행되는 스크립트가 너무 많음을 나타냅니다. 위의 예외와 마찬가지로, 이는 단일 스프레드시트에서 반복적으로 호출되는 맞춤 함수에서 가장 자주 발생합니다.