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 Fetch 헤더 | 통화당 100명 | 통화당 100명 |
| URL Fetch 헤더 크기 | 8KB / 호출 | 8KB / 호출 |
| URL 가져오기 게시 크기 | 호출당 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.: 동일한 스크립트는 아니지만 동시에 너무 많은 스크립트가 실행됨을 나타냅니다. 위의 예외와 마찬가지로 이 문제는 단일 스프레드시트에서 반복적으로 호출되는 맞춤 함수에서 가장 흔히 발생합니다.