세팅 가이드 · 나의 루틴

왜 이 세팅이 필요한가요?
이 앱은 본인의 Google 계정에 데이터를 저장합니다. 아무도 접근할 수 없고, 완전 무료입니다. 최초 1회만 세팅하면 그 이후로는 앱만 열면 바로 사용할 수 있어요.

📋 목차

스크립트 코드 다운로드
Google Apps Script 새 프로젝트
코드 붙여넣기
웹 앱으로 배포
Google 권한 승인
URL 복사 → 앱에 붙여넣기
자주 묻는 질문

🎯 준비물

세팅에 필요한 것은 딱 두 가지입니다:

Google 계정 (Gmail 있으면 OK)
브라우저 (Chrome, Safari, Edge 뭐든 상관없음)

📝 세팅 단계

스크립트 코드 다운로드

앱의 "서버 연결" 화면에서 "📥 스크립트 코드 다운로드" 버튼 클릭.

google-apps-script.gs 파일이 다운로드 폴더에 저장됩니다.

💡 팁: 이 파일은 일반 텍스트 파일입니다. 메모장이나 편집기로 열어볼 수 있어요. 열지 않아도 됩니다.

Google Apps Script 새 프로젝트

앱의 "🔗 Apps Script 열기" 버튼 클릭 (또는 아래 링크):

🔗 Apps Script 열기

Google 로그인 후 "새 프로젝트" 화면이 뜹니다.

script.google.com

            function myFunction() {

            }

👆 이 기본 코드가 편집기에 보여요

⚠ 처음이신가요? Google에서 "Apps Script에 접근 권한을 요청" 하는 팝업이 뜰 수 있어요. "허용" 눌러주세요.

코드 붙여넣기

3-1. 편집기의 기본 코드(function myFunction() {}) 전체 선택 → 삭제

편집기 안 클릭
Ctrl+A (Mac은 Cmd+A) 눌러서 전체 선택
Delete 키로 삭제

3-2. 다운받은 google-apps-script.gs 파일 열기

파일 우클릭 → "연결 프로그램" → "메모장"
또는 파일을 브라우저 창으로 드래그

3-3. 파일 내용 전체 복사해서 편집기에 붙여넣기

파일에서 Ctrl+A → Ctrl+C
Apps Script 편집기로 이동 → Ctrl+V

3-4. 좌측 상단 저장 아이콘(💾) 또는 Ctrl+S 저장

💡 팁: 저장할 때 프로젝트 이름 물어보면 "My Routine Sync" 등 아무거나 입력.

웹 앱으로 배포

4-1. 우측 상단 파란색 "배포" 버튼 클릭

4-2. "새 배포" 선택

4-3. 좌측 톱니바퀴 아이콘 클릭 → "웹 앱" 선택

4-4. 다음과 같이 설정:

설명: 원하는 이름 (예: "My Routine v1")
다음 사용자로 실행: 나
액세스 권한: 모든 사용자

4-5. 우측 하단 "배포" 클릭

💡 "모든 사용자"가 위험한 거 아닌가요?
아닙니다. 이건 "누구나 접근할 수 있는 URL을 만든다"는 뜻이지, "누구나 내 데이터를 본다"는 뜻이 아니에요. URL을 아는 사람만 접근 가능하고, 부부는 이 URL을 공유하면 됩니다.

Google 권한 승인 (첫 배포만)

처음 배포하면 Google이 권한 승인을 요청합니다.

5-1. "액세스 승인" 클릭

5-2. 자기 Google 계정 선택

5-3. "이 앱은 Google에서 확인하지 않았습니다" 경고 화면이 뜸

⚠ 걱정 마세요. 이 경고는 "Google이 검증한 앱이 아니다"라는 뜻일 뿐, 코드에 문제가 있다는 게 아닙니다. 본인이 만든 스크립트이므로 안전합니다.

5-4. 좌측 하단 "고급" 클릭

5-5. "[프로젝트명](으)로 이동(안전하지 않음)" 클릭

5-6. 권한 목록 확인 후 "허용" 클릭

💡 요청되는 권한들:

Google 스프레드시트에 연결 (데이터 저장용)
외부 서비스 연결 (앱이 서버와 통신)
본인의 스프레드시트에만 접근 (본인 데이터만)

URL 복사 → 앱에 붙여넣기

6-1. 배포가 완료되면 "웹 앱 URL" 이 표시됨

https://script.google.com/macros/s/AKfy.../exec

6-2. 이 URL을 전체 복사 (URL 옆의 복사 아이콘 클릭)

6-3. "나의 루틴" 앱으로 돌아가서 URL 입력창에 붙여넣기

6-4. "연결하기" 클릭

🎉 축하합니다!
세팅 완료. 이제 프로필을 만들고 PIN을 설정한 뒤 사용하시면 됩니다.

📱 세팅 후 할 일

1. 첫 사용자(본인) 등록

프로필 선택 화면 → "＋ 새 사용자" 클릭 → 이름, 생년월일, PIN 4자리 등록.

2. 폰 홈화면에 앱 추가

iPhone (Safari): 앱 URL 열기 → 하단 공유 버튼(□↑) → "홈 화면에 추가"

Android (Chrome): 앱 URL 열기 → 우측 상단 ⋮ 메뉴 → "홈 화면에 추가"

3. 가족과 공유 (선택)

가족(예: 배우자)과 같은 데이터를 쓰고 싶다면 앱 URL과 Apps Script URL 둘 다 알려주세요. 배우자는 자기 프로필과 PIN을 만들면, 데이터는 공유되고 로그인은 각자 합니다.

❓ 자주 묻는 질문

Q. 세팅이 정말 무료인가요? 나중에 요금 청구되지 않나요?

A. 완전 무료입니다. Google Apps Script는 개인용은 완전 무료이며, 카드 등록도 필요 없습니다. 하루 90분의 실행 시간을 무료로 제공하는데, 이 앱은 하루 몇 초도 안 씁니다.

Q. 내 데이터는 어디에 저장되나요?

A. 본인의 Google Drive에 자동 생성된 스프레드시트에 저장됩니다. "나의 루틴 데이터"라는 이름으로 찾아볼 수 있어요. 앱을 안 써도 언제든 데이터에 접근 가능합니다.

Q. 다른 사람이 내 데이터를 볼 수 있나요?

A. 아니오. Apps Script URL을 알아야만 접근 가능하고, 데이터는 본인 Google 계정에 저장됩니다. URL을 공개하지 않는 한 안전합니다. PIN 로그인으로 추가 보안도 있습니다.

Q. 배포할 때 "확인되지 않은 앱" 경고가 무서워요.

A. 정상입니다. 이 경고는 Google이 대량 배포용 앱만 "확인"해주기 때문에 뜨는 것으로, 개인 프로젝트는 대부분 이 경고를 봅니다. 본인이 만든 스크립트에 본인이 접근하는 것이라 안전합니다.

Q. 앱을 나중에 업데이트하려면 어떻게 하나요?

A. 앱은 웹 페이지라 자동으로 최신 버전이 뜹니다. Apps Script 코드가 업데이트되면 새 파일을 받아 붙여넣고 "배포 관리 → 기존 배포 편집 → 새 버전 → 배포"로 업데이트할 수 있습니다. URL은 그대로 유지됩니다.

Q. 폰을 바꾸면 데이터도 옮겨야 하나요?

A. 아니오. 데이터는 Google Sheets에 있어서 폰을 바꿔도 그대로입니다. 새 폰에서 앱 URL만 열면 됩니다.

Q. PIN을 잊어버리면 어떻게 하나요?

A. Google Sheets에서 해당 사용자 행의 pin_hash 칸을 비우면 PIN 없이 로그인 가능해집니다. 그 후 앱에서 다시 PIN을 설정하세요.

Q. Apps Script 배포 URL이 어디였는지 잊어버렸어요.

A. script.google.com에서 프로젝트 열기 → 우측 상단 "배포" → "배포 관리" 클릭 → URL이 표시됩니다.

🆘 문제 해결

❌ "연결하기" 눌러도 반응이 없어요

A. 다음을 확인하세요:

URL이 정확한가? (/exec로 끝나는지)
Apps Script 배포 시 액세스 권한이 "모든 사용자"인가?
인터넷 연결 정상인가?

❌ "AUTH_REQUIRED" 오류가 뜹니다

A. PIN 세션이 만료되었어요. 로그아웃 후 다시 PIN으로 로그인하세요. (기본 30일 유지)

❌ 배포는 됐는데 앱이 에러를 뱉어요

A. Apps Script 편집기에서 testSetup 함수를 실행해보세요. 처음 실행 시 권한 요청이 뜨는데, 이걸 승인하면 앱도 정상 작동합니다.