Google 서비스 할당량

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