본문으로 건너뛰기

구글 앱스 스크립트 웹앱, 배포 순서와 권한표

구글 앱스 스크립트 웹앱으로 시트 자료의 입력 폼 · 조회 화면을 주소 하나로 여는 방법을 정리했습니다. 테스트 배포와 새 배포의 차이, 실행 사용자 × 접근 권한 조합표, 시트를 읽고 쓰는 doGet · doPost 예시 코드, 할당량과 흔한 오류 6가지를 담았습니다.

구글 앱스 스크립트 웹앱, 배포 순서와 권한표

구글 앱스 스크립트 웹앱은 스크립트에 doGet 함수(데이터를 받을 일이 있으면 doPost 함수)를 만든 뒤 배포 > 새 배포에서 유형을 웹 앱으로 고르고, 누구 계정으로 실행할지와 누가 열 수 있는지를 정하면 /exec로 끝나는 주소 하나가 나오는 방식입니다. 구글 시트 자료로 입력 폼이나 조회 화면을 만들 때 서버를 따로 두지 않아도 됩니다. 꼭 기억할 점은 코드를 고친 뒤 저장만 해서는 이 주소에 반영되지 않는다는 것입니다 — 배포 관리에서 새 버전으로 바꿔야 바뀝니다.

이 글은 웹앱 배포만 다룹니다. 편집기 여는 법 · 첫 실행 승인 · 트리거는 구글 앱스 스크립트 사용법, 자동화 예시 5개에 있고, 시트를 여러 사람이 함께 쓰는 기본 설정은 구글 스프레드시트 사용법, 공유 업무표 8단계에 있습니다.

구글 앱스 스크립트 웹앱으로 무엇을 만들 수 있나요

공식 문서가 정한 조건은 두 가지입니다. 스크립트에 doGet이나 doPost 함수가 있을 것, 그 함수가 HTML 화면(HtmlOutput)이나 글 · 데이터(TextOutput)를 돌려줄 것. 브라우저로 주소를 열면 doGet이, 다른 프로그램이 POST 요청(데이터를 담아 보내는 요청)을 보내면 doPost가 실행됩니다. 함수가 받는 e에는 주소 뒤에 붙은 값(e.parameter)과 POST 본문(e.postData.contents)이 들어 있습니다.

  • 입력 폼 — HTML 화면에서 받은 값을 시트에 한 줄씩 추가합니다. 구글 설문지보다 입력란 배치와 검사 규칙을 자유롭게 짤 수 있습니다.
  • 조회 화면 — 주문번호나 이름을 넣으면 시트에서 해당 행만 찾아 보여 줍니다.
  • 데이터 받는 주소 — 다른 서비스가 보내는 알림을 doPost로 받아 시트에 쌓습니다.

시트에 붙은 스크립트와 따로 만든 독립형 스크립트 모두 웹앱이 될 수 있습니다. 시트에서 시작한다면 시트 메뉴의 확장 프로그램 > Apps Script로 편집기를 엽니다.

웹앱 배포는 어떤 순서로 하나요

  1. 함수 저장 — 아래 예시처럼 doGet 함수를 쓰고 저장합니다.
  2. 테스트 배포로 확인 — 오른쪽 위 배포 > 테스트 배포에서 유형 선택 옆 톱니(배포 유형 사용 설정)를 눌러 웹 앱을 고르고, /dev로 끝나는 주소를 복사해 열어 봅니다.
  3. 새 배포 만들기 — 배포 > 새 배포에서 같은 방법으로 웹 앱을 고르고 설명을 적습니다.
  4. 실행 사용자 · 접근 권한 고르기 — 아래 권한표에서 쓰임새에 맞는 조합을 고릅니다.
  5. 배포와 권한 승인 — 배포를 누르고, 스크립트가 쓰는 권한(시트 읽기 · 쓰기 등)을 승인하라는 화면이 뜨면 계정을 골라 허용합니다.
  6. 주소 공유 — /exec로 끝나는 웹 앱 주소를 접근 권한을 준 사람에게 보냅니다.
  7. 고친 뒤 다시 배포 — 배포 > 배포 관리에서 쓰고 있는 배포를 골라 수정(연필)을 누르고, 버전을 새 버전으로 바꿔 배포합니다. 주소와 배포 ID는 그대로입니다.

구글 앱스 스크립트 웹앱의 주소가 두 가지인 이유는 쓰임이 달라서입니다. 공식 문서는 /dev 주소를 개발 중 시험용으로만 쓰라고 안내합니다.

구분/dev 주소(테스트 배포)/exec 주소(새 배포)
실행되는 코드가장 최근에 저장한 코드배포할 때 고른 버전
열 수 있는 사람스크립트 수정 권한이 있는 사람접근 권한에서 허용한 사람
코드를 고친 뒤저장하면 바로 반영배포 관리에서 새 버전으로 수정해야 반영
쓰는 때개발 중 확인실제 사용자에게 공유

실행 사용자와 접근 권한은 어떻게 고르나요

새 배포 화면에는 설정이 두 가지 있습니다. 누구 계정으로 실행할지(실행 사용자)와 누가 주소를 열 수 있는지(접근 권한)입니다. 각 설정은 스크립트 설정 파일(매니페스트)의 executeAs · access 값과 짝을 이루고, 화면에 보이는 이름은 계정 언어에 따라 조금 다를 수 있습니다.

설정매니페스트 값뜻맞는 쓰임
실행: 나(배포한 사람)USER_DEPLOYING누가 열든 배포한 사람 권한으로 실행시트를 공유하지 않고 입력 · 조회만 열어 줄 때
실행: 웹 앱에 액세스하는 사용자USER_ACCESSING여는 사람 계정으로 실행, 사람마다 처음에 권한 승인각자 자기 드라이브 · 메일을 다룰 때
접근: 나만MYSELF배포한 사람만 실행혼자 쓰는 도구, 공유 전 확인
접근: 같은 도메인 사용자DOMAIN배포한 사람과 같은 도메인 계정만회사 계정으로 쓰는 사내 폼
접근: 로그인한 구글 계정ANYONE구글 계정으로 로그인한 누구나외부 협력처가 로그인해 쓰는 화면
접근: 모든 사용자ANYONE_ANONYMOUS로그인하지 않은 사람까지 누구나공개 신청 폼, 다른 서비스가 보내는 데이터 받기

자주 쓰는 조합은 사내 입력 폼이면 나로 실행 + 같은 도메인, 공개 접수 폼이면 나로 실행 + 모든 사용자입니다. 나로 실행하면 접속한 사람이 시트 공유 없이도 코드가 허용한 범위만큼 시트를 읽고 쓰게 되므로, doGet이 돌려주는 값에서 연락처 같은 개인정보 열은 빼고 내보냅니다. 여는 사람 계정으로 실행하는 웹앱은 새 사용자가 승인하는 속도에 한도가 있다고 공식 문서에 적혀 있어, 처음 여는 사람이 한꺼번에 몰리는 화면이라면 나로 실행하는 쪽을 먼저 검토합니다.

시트를 읽고 쓰는 코드는 어떻게 쓰나요

다른 화면이나 서비스가 보낸 JSON을 접수 시트에 한 행으로 추가하고(doPost), 머리 행을 뺀 A~C열(접수 시각 · 항목 · 처리 상태)만 JSON으로 돌려주는(doGet) 예시입니다. 이름이 들어가는 D열은 돌려주지 않습니다. 시트 ID는 시트 주소에서 /d/ 와 /edit 사이에 있는 문자열입니다.

const SHEET_ID = '시트 주소의 /d/ 와 /edit 사이 문자열';

function doGet(e) {
  const sheet = SpreadsheetApp.openById(SHEET_ID).getSheetByName('접수');
  const rows = sheet.getDataRange().getValues().slice(1)
    .map(r => r.slice(0, 3));
  return ContentService.createTextOutput(JSON.stringify(rows))
    .setMimeType(ContentService.MimeType.JSON);
}

function doPost(e) {
  const data = JSON.parse(e.postData.contents);
  const lock = LockService.getScriptLock();
  lock.waitLock(10000);
  SpreadsheetApp.openById(SHEET_ID).getSheetByName('접수')
    .appendRow([new Date(), data.item, '접수', data.name]);
  lock.releaseLock();
  return ContentService.createTextOutput('ok');
}

짚을 곳은 세 군데입니다. 첫째, ContentService로 돌려준 값은 보안상 script.googleusercontent.com의 일회용 주소로 넘겨져 전달되므로, 다른 프로그램에서 부를 때는 넘겨받은 주소를 따라가도록 설정합니다(curl이라면 -L). 둘째, 여러 요청이 같은 시트를 동시에 고치는 충돌을 막으려고 LockService(코드 구간을 한 번에 하나만 실행하게 묶는 기능)를 썼습니다. 셋째, 접근 권한이 모든 사용자이면 주소를 아는 누구나 doPost를 부를 수 있으므로, item · name 값이 비어 있거나 너무 길면 저장하지 않는 검사를 더합니다.

할당량과 흔한 오류는 무엇인가요

공식 할당량 표에서 구글 앱스 스크립트 웹앱 운영에 걸리는 값은 다음과 같습니다. 공식 안내에서 확인한 내용이며 예고 없이 바뀔 수 있습니다.

  • 한 번 실행 시간 6분(개인 · 워크스페이스 계정 같음)
  • 사용자당 동시 실행 30개, 스크립트당 동시 실행 1,000개
  • 외부 주소 호출(UrlFetchApp) 하루 20,000회(개인 계정) · 100,000회(워크스페이스 계정)

배포 뒤 자주 만나는 오류 6가지와 해결 순서입니다.

증상원인해결
코드를 고쳤는데 화면이 그대로/exec 주소는 배포할 때 고른 버전을 실행배포 관리 > 수정 > 새 버전으로 배포
다른 사람이 열면 접근이 막힘접근 권한이 나만 · 같은 도메인이거나, /dev 주소를 공유함접근 권한을 다시 고르고 /exec 주소를 공유
405 오류와 Sorry, the file you have requested does not exist 문구주소 값이나 POST 본문에 시스템 예약 이름 c · sid를 씀값 이름을 다른 낱말로 바꿈
다른 프로그램이 응답을 못 받음응답이 일회용 주소로 넘겨져 전달됨부르는 쪽에서 리다이렉트(주소 넘김) 따라가기를 켬
실행 시간 초과한 번 실행 6분 한도한 번에 처리할 행 수를 줄이고 나눠 실행
소유권을 옮긴 뒤 작동하지 않음다른 도메인 계정 · 공유 드라이브로 소유권이 바뀜새 소유자나 공동작업자가 그 도메인에서 다시 배포

자주 묻는 질문

웹앱 주소를 바꾸지 않고 고칠 수 있나요?

네. 배포 > 배포 관리에서 쓰고 있는 배포를 수정해 새 버전을 고르면, 같은 주소 · 같은 배포 ID로 모든 사용자에게 새 코드가 적용됩니다. 새 배포를 또 만들면 주소가 하나 더 생기므로, 이미 공유한 주소를 유지하려면 수정 쪽을 씁니다.

로그인하지 않은 사람도 쓰게 할 수 있나요?

접근 권한을 모든 사용자(ANYONE_ANONYMOUS)로 두면 됩니다. 로그인하지 않은 사람은 자기 계정으로 승인할 수 없으므로 실행 사용자는 나로 둡니다. 이 경우 주소를 아는 누구나 실행할 수 있어, 돌려주는 자료는 공개해도 되는 값으로 줄이고 입력값 검사를 넣습니다.

구글 사이트 페이지에 넣을 수 있나요?

넣을 수 있습니다. 먼저 웹앱을 배포하고, 사이트 페이지에서 삽입 > URL 삽입에 웹 앱 주소를 붙이면 프레임으로 들어갑니다. 웹앱 접근 권한과 도메인 관리자 설정이 허용해야 보이고, 방문자에게 승인 화면이 뜰 수 있습니다.

여러 명이 동시에 입력해도 되나요?

사용자당 동시 실행 30개, 스크립트당 1,000개 한도 안에서는 함께 돌아갑니다. 같은 시트에 쓰는 코드는 예시처럼 LockService로 순서를 세우고, 행사 신청처럼 짧은 시간에 요청이 몰리는 화면이라면 시트 대신 데이터베이스를 쓰는 구조로 옮길지 검토합니다.

오늘 할 일

쓰려는 시트에서 확장 프로그램 > Apps Script를 열어 위 doGet 예시를 붙여 저장하고, 배포 > 테스트 배포의 /dev 주소로 시트 자료가 JSON으로 보이는지 확인하세요.

이어서 읽기 — 웹훅이란, API 비교표와 설정 점검 5가지

FacebookX

이 글과 맞는 서비스

이어서 읽기

블로그 전체 글 목록 →

카카오톡 상담식스원 고객센터 카카오톡 채널 (새 창)