인사이드 패스 활동지 — 설치와 사용

GOOGLE APPS SCRIPT

인사이드 패스 단계별 과제
설치와 사용

구글 스프레드시트 하나로 돌아갑니다. 서버도 비용도 없습니다.
학생은 링크 하나로 접속해 기록하고, 선생님은 시트에서 읽고 피드백합니다.

＋ 사본 만들기누르면 새 탭에서 내 드라이브로 복사됩니다 ↗

막히시면 언제든 연락 주세요

보평중학교 김푸름 0508-4262-0639

문자로 남겨 주시면 답 드리겠습니다. 어떤 화면에서 막히셨는지 함께 적어 주세요.

먼저 이것만 하시면 됩니다

1 위 단추로 사본 만들기 → 2 초기 설정 실행하고 권한 주기 → 3 웹 앱으로 배포

여기까지 10분입니다. 나머지는 수업하면서 필요할 때 보세요.

1사본 만들기

받으신 스프레드시트를 내 것으로 복사합니다.

＋ 사본 만들기새 탭에서 열립니다 ↗

위 단추를 누릅니다
새 탭에 「문서 사본 만들기」 창이 뜹니다. 이름을 3학년 인사이드 패스 처럼 알아보기 쉽게 바꾸세요. 폴더는 아무 데나 괜찮습니다.
사본 만들기 를 누릅니다
내 드라이브에 복사되고 그 시트가 바로 열립니다.
이제부터 이 시트를 씁니다
원본은 다시 안 봐도 됩니다. 주소창의 주소가 바뀌었는지 확인하세요.

→ 로그인 창이 뜨면

학교 구글 계정으로 로그인하세요. 개인 계정으로 만들면 나중에 학생 접속에서 걸릴 수 있습니다.

✓ 사본에는 코드도 함께 복사됩니다

Apps Script 코드가 그대로 따라옵니다. 따로 붙여넣을 것이 없습니다.

! 사본마다 데이터가 따로입니다

선생님 A의 사본과 선생님 B의 사본은 아무 상관이 없습니다. 학생 기록도 각자 자기 시트에만 쌓입니다.

2초기 설정 · 권한 승인

여기가 가장 헷갈리는 곳입니다. 천천히 따라오세요.

시트 위 메뉴에서 확장 프로그램 → Apps Script
새 탭에 코드 편집기가 열립니다. 코드를 고치실 필요는 없습니다. 권한을 한 번 주려고 여는 것입니다.
왼쪽에서 Code.gs 를 고르고, 위쪽 함수 목록에서 setupSheets 선택
「실행」 옆 드롭다운에서 고르면 됩니다.
실행 을 누릅니다
권한 승인 창이 뜹니다.
권한 검토 → 계정 선택
학교 구글 계정을 고르세요.
「Google에서 확인하지 않은 앱」 화면
✕ 여기서 멈추지 마세요
무서운 말이 나오지만 선생님이 직접 만든 코드라 그렇습니다. 구글에 심사를 맡기지 않은 개인 스크립트는 모두 이렇게 나옵니다.

화면이 이렇게 생겼습니다.
```
⚠ Google에서 확인하지 않은 앱입니다

이 앱을 사용하려면 개발자를 신뢰해야 합니다.

                        ← 잘 보이지 않는 작은 글씨
고급                              [ 뒤로 ]
```
① 왼쪽 아래 고급 을 누릅니다. 접혀 있던 글이 펼쳐집니다.
② 맨 아래 「(프로젝트 이름)(으)로 이동(안전하지 않음)」 을 누릅니다.

「안전하지 않음」이라는 말에 놀라지 마세요. 구글이 심사하지 않았다는 뜻이지 위험하다는 뜻이 아닙니다.
허용
스프레드시트를 읽고 쓸 권한을 줍니다. 이 시트 안에서만 동작합니다.

스프레드시트 탭으로 돌아갑니다

Apps Script는 새 탭에서 열렸으니, 브라우저 위쪽에서 원래 시트 탭을 다시 누르세요.
화면 가운데에 이런 창이 떠 있습니다.

완료

시트를 만들었습니다.

1) "계열" 시트에서 단계·낱말·영상URL을 확인하세요.
2) "설정"의 현재차시를 오늘 차시로 맞추세요.
3) 배포 > 새 배포 > 웹 앱 으로 배포한 뒤 주소를 등록하세요.

명단은 비워 두면 됩니다. 학생이 처음 접속할 때 등록됩니다.

                                          [ 확인 ]

확인을 누르면 됩니다. 아래쪽에 시트 탭이 여러 개 생긴 것이 보입니다 — 설정 계열 명단 원본데이터 대시보드.

✕ 창이 안 뜨고 빨간 오류가 나온다면

권한 승인을 끝까지 안 한 것입니다. 2~6번을 다시 하세요.
「승인 필요」라는 말이 보이면 권한 검토를 눌러 다시 진행하시면 됩니다.

→ 권한은 한 번만

다음부터는 안 물어봅니다. 사본을 새로 만들면 그때 또 한 번 합니다.

3웹 앱으로 배포하기

학생에게 줄 링크를 만드는 단계입니다.

Apps Script 화면 오른쪽 위 배포 → 새 배포
톱니바퀴(유형 선택) → 웹 앱
「라이브러리」나 「추가 기능」이 아니라 웹 앱입니다.
설정을 이렇게 맞춥니다

항목 값

설명 아무거나. 비워도 됩니다

다음 사용자로 실행 나 (선생님 계정)

액세스 권한 모든 사용자

! 「액세스 권한」을 꼭 확인하세요
모든 사용자로 두어야 학생이 들어옵니다. 「나만」이면 선생님 말고는 아무도 못 열고, 학생 화면이 하얗게 뜹니다.

학교 계정 정책상 「모든 사용자」가 안 보이면 「○○학교의 모든 사용자」 를 고르세요. 학생도 같은 도메인이면 됩니다.
배포 를 누르면 주소가 나옵니다
...script.google.com/macros/s/AKfy.../exec
이 주소를 복사하세요. 이게 학생용 링크입니다.
시트로 돌아가 🏐 인사이드 패스 → 🔗 링크 보기
주소를 붙여넣으라는 창이 뜹니다. 방금 복사한 주소를 넣고 확인하세요.
그러면 링크 두 개가 나옵니다.
```
링크

■ 학생용
https://script.google.com/macros/s/AKfy.../exec

■ 교사용 (학생에게 알려주지 마세요)
https://script.google.com/macros/s/AKfy.../exec?page=admin&key=a1b2c3d4e5f6
```
학생용만 학생에게 주세요. 다음부터는 이 메뉴에서 언제든 다시 볼 수 있습니다.

항목	값
설명	아무거나. 비워도 됩니다
다음 사용자로 실행	나 (선생님 계정)
액세스 권한	모든 사용자

교사용 화면도 쓰고 싶다면 (선택)

교사용 화면 — 파일 두 개를 더 넣어야 합니다

순회할 때 휴대폰으로 현황을 보는 화면입니다. 시트를 여는 것보다 가볍고, 학생 카드가 한 장씩 세로로 늘어섭니다. 안 쓰셔도 학생용은 잘 돌아갑니다.

✕ 먼저 파일을 넣지 않으면 오류가 납니다

Exception: Admin(이)라는 이름의 HTML 파일을 찾을 수 없습니다.

이 화면은 따로 받은 파일 두 개를 넣어야 동작합니다. 안 쓰실 거면 이 부분을 건너뛰셔도 됩니다. 학생용은 그대로 잘 돌아갑니다.

Apps Script에서 ＋ → HTML
이름을 Admin 으로 짓습니다. .html은 빼고요.
새로 생긴 파일 안을 전부 지우고 받으신 Admin.html 내용을 붙여넣습니다.
Code.gs 맨 아래에 코드를 더합니다
받으신 Admin_추가코드.gs 내용을 Code 파일 맨 끝에 붙여넣으세요. 새 파일을 만드는 게 아니라 기존 Code 파일 아래에 이어 붙이는 것입니다.
저장 → 새 버전으로 배포
배포 → 배포 관리 → 연필 → 버전: 새 버전 → 배포
교사용 링크로 들어가 보세요
메뉴 🔗 링크 보기 에 있는 두 번째 주소입니다.

무엇이 보이나

인사이드 패스 3차시 / 8 [새로고침] [전체] [미제출 4] [작성 중 2] [절차 오답 3] [왜냐하면 빔 1] 전체 28 제출 22 작성 중 2 미제출 4 ┌──────────────────────────────────┐ │ 홍길동 30115 4단계 │ │ 본 것 발목 · 나아졌다 · 다음 터치 │ │ ──────────────────────────────── │ │ 발목에 힘을 주니까 공이 덜 굴렀다 │ │ 들은 말 — 디딤발이 멀다고 하셨다 │ │ 절차 2차시 연속 틀림 · 4단계 무릎↔스캔 │ │ 1 2 3 4 5 6 7 8 │ │ 2 3 3 4 │ └──────────────────────────────────┘

탭	누가 걸리나
미제출	오늘 아직 안 낸 학생. 순회하며 챙길 학생
작성 중	임시저장만 하고 제출을 안 누른 학생
절차 오답	절차 퀴즈를 연속으로 틀린 학생. 낱말을 못 외운 것
왜냐하면 빔	제출은 했는데 서술이 빈 학생

→ 「절차 오답」 탭을 자주 보세요

연속으로 틀린다는 것은 동작은 하는데 말로는 모른다는 뜻입니다. 그 학생에게는 시범보다 낱말을 짚어 주는 편이 낫습니다.

! 보기만 됩니다

피드백을 쓰거나 차시를 넘기는 것은 시트에서 하셔야 합니다. 이 화면은 순회 중에 눈으로 훑는 용도입니다.

! 교사용 주소를 학생에게 주지 마세요

주소 안에 암호가 들어 있습니다. 암호는 설정 시트의 교사암호 칸에 있고, 원하시면 바꿔도 됩니다.
바꾸면 메뉴 → 🔗 링크 보기 로 새 주소를 다시 확인하세요.

4수업 전 준비

시트 두 개만 손보면 됩니다.

계열 시트 — 과제를 정하는 곳

12단계가 미리 채워져 있습니다. 이 시트를 고치면 학생 화면이 바뀝니다. 코드는 안 건드립니다.

열	무엇을 넣나
단계	1부터 차례로
층	A · B · C. 카드 색과 무늬가 나뉩니다
이름	화면에 보이는 과제 이름. 비우면 그 단계가 안 나옵니다
절차낱말	쉼표로 구분. `스캔,무릎찍고,패스` 절차 퀴즈와 화면에 씁니다
주의사항	카드에 늘 보이는 한 줄
영상URL	드라이브 공유 링크. 비우면 「영상 보기」가 안 나옵니다
초점원리	판단 · 터치 · 위치 · 디딤발 · 골반 · 발목 · 스윙 중 하나
통과기준	`연속 10회` 처럼. 비우면 학생이 감으로 판정합니다

! 절차낱말은 쉼표 뒤에 띄어쓰지 마세요

스캔, 무릎찍고 처럼 띄우면 퀴즈 정답이 영영 안 맞습니다. 스캔,무릎찍고 로 붙여 쓰세요.

! 단계 수는 수업 시작 전에 정하세요

기록이 쌓인 뒤에 늘리거나 줄이면 학생 시트는 자동으로 맞춰지지만 원본데이터는 경고만 뜹니다.

설정 시트

항목	뜻
현재차시	오늘이 몇 차시인가. 메뉴 ▶ 차시 넘기기 로 바꾸는 게 편합니다
총차시	전체 차시. 마지막 차시에 「단원 마무리」가 열립니다
자동등록	`Y` 면 학생이 처음 접속할 때 명단에 자동으로 들어옵니다. 첫 시간이 끝나면 `N` 으로 바꾸세요. 장난 등록을 막습니다
제출후수정허용	`N` 이면 한 번 제출한 뒤 못 고칩니다
교사암호	교사용 웹 화면에 들어갈 때 씁니다. 학생에게 알려주지 마세요

→ 명단은 비워 두세요

미리 채우실 필요 없습니다. 학생이 학번 · 이름 · 구글 계정으로 처음 접속하면 자동으로 등록됩니다.

5수업 중에 쓰는 법

일상 운영은 전부 시트 메뉴에서 합니다.

▶ 차시 넘기기… 수업 시작할 때 오늘 차시로 맞춥니다. 이걸 안 하면 지난 차시에 덮어씁니다

🏠 대시보드 새로고침 순회하며 보는 현황판. 차시별 통과 단계가 가로로 늘어섭니다

미제출자 확인… 아직 안 낸 학생과 작성 중인 학생을 알려 줍니다

🔍 학생 찾기… 학번이나 이름 일부로 그 학생 시트를 엽니다

이름 오타 맞추기 명단에서 이름을 고쳤을 때 학생 시트 이름도 맞춥니다

🔗 링크 보기 학생용 링크와 교사용 링크

→ 시트를 열면 오늘 차시가 알림으로 뜹니다

지난 시간에 열어 둔 채로 수업에 들어가는 일을 막습니다.

학생이 하는 일

링크 접속 ↓ 학번 · 이름 · 구글 계정 앞부분 입력 ↓ 수업 시작 전 지난 도달 단계 확인 → 절차 퀴즈 → 원리 퀴즈 ↓ (첫 차시나 결석 뒤 첫 참여면 건너뜁니다) 수업 중 단계 카드에서 해낸 것 체크 ↓ 통과한 칸은 접히고, 다음 한 칸만 미리 보입니다 수업 끝 오늘 본 것 → 결과 → 왜냐하면 → 다음에 볼 것 ↓ 제출

✓ 매 차시 1단계부터 다시 시작합니다

지난 시간에 5단계까지 갔어도 오늘 다시 1단계부터 올라옵니다. 앱이 지난 기록을 기억해 「지난번에 5단계까지 갔습니다」로 알려 줍니다.

6시트에 데이터가 어떻게 쌓이나

학생이 제출을 누르면 세 곳에 동시에 들어갑니다.

학생이 「제출」 │ ├──▶ 30115 홍길동 학생 개별 시트 · 차시가 세로로 쌓임 │ 선생님이 피드백을 쓰는 곳 │ ├──▶ 원본데이터 한 행 = 한 학생 · 한 차시 │ 반 전체를 가로로 훑을 때 │ └──▶ 제출로그 숨김 · 제출할 때마다 한 줄 "분명 냈는데 없다" 확인용

시트 여섯 개

시트	누가 채우나	무엇이 들어 있나
계열	교사	단계 정의. 여기를 고치면 앱이 바뀝니다
설정	교사	현재차시 · 총차시 · 자동등록 등
명단	자동	학번 · 이름 · 계정 · 최초등록 · 최근접속
30115 홍길동	자동 + 교사	학생별 한 장. 차시가 세로로. 맨 오른쪽 「교사 피드백」 칸에 쓰면 학생 화면에 뜹니다
원본데이터	자동	차시당 한 줄로 덮어씁니다. 중복이 안 쌓입니다
제출로그	자동 · 숨김	제출 이력. 평소엔 볼 일 없습니다
대시보드	자동	순회용 현황판. 새로고침할 때 다시 그립니다

학생 개별 시트의 생김새

차시 │ 날짜 │ 1 2 3 … 12 │ 통과 │ 본것 │ 결과 │ 왜냐하면 │ … 선생님께 들은 말 다음에볼것 · 퀴즈 마무리·고친것 마무리·원인설명 교사 피드백 ← 여기에 씁니다

선생님은 한 학생의 기록을 세로로 읽으며 맨 오른쪽 칸에 피드백을 씁니다. 학생은 다음 차시에 앱을 열 때 그 글을 먼저 봅니다.

→ 같은 차시를 다시 내면 덮어씁니다

학번과 차시로 행을 찾기 때문에, 두 번 내도 줄이 두 개 생기지 않습니다. 이미 쓰신 교사 피드백은 지워지지 않습니다.

! 학생 시트를 직접 고치지 마세요

「교사 피드백」 칸만 쓰시면 됩니다. 다른 칸을 고치면 학생이 다시 제출할 때 덮어씁니다.

7피드백 주기

두 가지 방법이 있습니다.

직접 쓰기

학생 시트 맨 오른쪽 「교사 피드백」 칸에 씁니다. 학생이 앱을 열면 화면 맨 위에 뜹니다.

AI에게 맡기기

40명에게 일일이 쓰기는 어렵습니다. 그 부담을 덜려고 만든 기능입니다.
AI가 시트에 직접 접속하지 않습니다. 선생님이 복사해서 옮기는 방식이라 어떤 AI를 쓰셔도 됩니다 — ChatGPT · Gemini · Claude 무엇이든요.

메뉴 ✎ AI 피드백 만들기 / 반영하기 를 누르면 오른쪽에 사이드바가 열립니다. ① 과 ② 두 칸으로 되어 있습니다.

① 기록 내보내기

① 기록 내보내기

차시            [ 3차시           ▾ ]
                [ 전체 차시 모아서    ]

☑ 제출을 마친 학생만
☑ 피드백 지시문 함께 넣기

        [ 텍스트 만들기 ]

┌────────────────────────────┐
│ (만들어진 글이 여기 나옵니다)      │
│                              │
└────────────────────────────┘

     [ 전체 복사 ]  [ 지시문만 복사 ]

항목	설명
차시	한 차시만 볼지, 전체 차시 모아서 볼지. 모아서 보는 쪽을 권합니다. 한 차시만 보면 AI가 할 말이 없어 일반론이 나옵니다. 여러 차시를 놓고 봐야 변화의 궤적이 보입니다
제출을 마친 학생만	체크를 풀면 임시저장한 학생도 들어옵니다. 아무도 안 나올 때는 이걸 풀어 보세요
지시문 함께 넣기	켜 두세요. 이 수업의 성취기준과 수행 원리 낱말이 앞에 붙습니다

차시를 고르고 텍스트 만들기
아래 칸에 글이 만들어집니다. 몇 명이 들어갔는지도 알려 줍니다.
전체 복사
지시문과 학생 답안이 한꺼번에 복사됩니다.
AI 대화창에 붙여넣고 보냅니다
새 대화를 여는 게 좋습니다. 앞의 이야기가 섞이지 않게요.

만들어진 글이 어떻게 생겼는지 보기

당신은 이 학생을 가르치는 중학교 체육 교사입니다.
「인사이드 패스 단계별 과제」 수업 3차시 기록을 보고…

(지시문이 이어집니다 — 성취기준, 과제 계열,
 수행 원리 일곱 낱말, 피드백에 담을 것)

===== 학생 기록 =====

[[30115]]
3차시 | 4단계 통과 | 본 것: 발목 | 결과: 나아졌다
| 왜냐하면: "발목에 힘을 주니 덜 굴렀다" | 다음에 볼 것: 터치

[[30116]]
...

✓ 학생 이름은 나가지 않습니다

학번만 내보냅니다. 매칭에는 그것으로 충분합니다.

② 피드백 붙여넣기

② 피드백 붙여넣기

AI 답변을 통째로 붙여넣으세요.

┌────────────────────────────┐
│                              │
│                              │
└────────────────────────────┘

     [ 확인하기 ]

  → 확인을 눌러야 아래 단추가 켜집니다

  [ 학생에게 반영하기 ]

AI 답변을 통째로 복사해 붙여넣습니다
앞뒤에 인사말이 붙어 있어도 괜찮습니다. 알아서 걸러냅니다.
확인하기
어느 학생 것인지 맞춰 보여 줍니다.
```
8명을 찾았습니다.

30115 홍길동
  발목에 힘을 주었더니 공이 덜 굴렀다고…

30116 이서연
  네 번째 단계에서 멈춘 것이…
```
여기서 한 번 읽어 보세요. 이상한 것이 있으면 반영하지 말고 다시 시키면 됩니다.
학생에게 반영하기
각 학생 시트의 「교사 피드백」 칸에 들어갑니다. 학생이 다음에 앱을 열면 화면 맨 위에 뜹니다.

! 붙여넣자마자 반영하지 마세요

확인하기를 먼저 누르고 결과를 보세요. AI가 명단에 없는 학번을 지어내는 일이 실제로 있습니다.
확인을 안 누르면 반영 단추가 켜지지 않게 해 두었습니다.

✕ 「학생을 찾지 못했습니다」가 나오면

AI가 형식을 어긴 것입니다. 학번이 [[30115]] 처럼 한 줄에 단독으로 있어야 합니다.

이렇게 다시 시켜 보세요.
「학번을 [[30115]] 형식으로 한 줄에 단독으로 쓰고, 다음 줄부터 피드백 본문만 써 주세요.」

직접 프롬프트를 쓰고 싶을 때

지시문만 복사 를 누르면 학생 답안 없이 지시문만 나옵니다. 선생님이 쓰신 프롬프트 앞에 붙이시면 형식이 맞아 반영이 됩니다.

→ 언제 쓰면 좋은가

매 차시 쓰실 필요 없습니다. 단원 중간과 마지막에 「전체 차시 모아서」로 한 번씩 돌리는 것으로 충분합니다.
매 차시 기록이 한 줄뿐이면 AI가 할 말이 없어 일반론이 나옵니다.

8잘 안 될 때

→ 가장 많이 겪는 두 가지

학생 화면이 하얗다 → 배포의 액세스 권한을 모든 사용자로
고쳤는데 그대로다 → 배포 → 배포 관리 → 연필 → 버전: 새 버전

증상별로 모두 보기 (9가지)

증상	이유와 해결
교사용 링크에서 「Admin 파일을 찾을 수 없습니다」	`Admin.html` 파일을 아직 안 넣으신 것입니다. 3단계의 「교사용 화면」 부분을 보세요. 학생용은 이것과 상관없이 잘 돌아갑니다.
교사용 링크에서 「권한이 없습니다」	주소 끝의 `key=` 뒤 암호가 `설정` 시트의 교사암호와 다릅니다. 메뉴 🔗 링크 보기 로 주소를 다시 확인하세요.
학생 화면이 하얗게 뜬다	배포 설정의 액세스 권한이 「나만」으로 되어 있습니다. `배포 → 배포 관리 → 연필` 에서 모든 사용자로 바꾸세요.
「시작하기」 버튼이 안 눌린다	`계열` 시트의 이름 열이 비어 있습니다. 한 줄이라도 채우면 열립니다.
코드를 고쳤는데 그대로다	저장만으로는 반영되지 않습니다. `배포 → 배포 관리 → 연필 → 버전: 새 버전 → 배포`
메뉴가 안 보인다	스프레드시트를 완전히 닫았다가 다시 여세요. 메뉴는 시트를 열 때 한 번만 만들어집니다.
절차 퀴즈가 영영 안 맞는다	`계열`의 절차낱말에 쉼표 뒤 띄어쓰기가 있습니다. `스캔,무릎찍고` 로 붙여 쓰세요.
학생이 「등록되지 않은 계정」이라고 한다	`설정`의 자동등록이 `N` 입니다. 첫 시간에는 `Y` 로 두세요.
「이 계정은 다른 학번으로 등록」	학번을 잘못 넣고 한 번 등록한 것입니다. `명단` 시트에서 그 줄의 학번을 고쳐 주세요.
학생이 제출했는데 시트에 없다	`제출로그` 시트를 보세요(숨김 해제 필요). 거기 있으면 저장은 된 것입니다. 차시가 다를 수 있습니다.
영상 보기가 안 나온다	`계열`의 영상URL이 비어 있거나, 드라이브 파일이 「링크가 있는 모든 사용자 · 뷰어」가 아닙니다.

→ 그래도 안 되면

학생 화면에서 F12 → Console 탭의 빨간 글씨 첫 줄을 알려 주시면 원인을 좁힐 수 있습니다.

그래도 안 되면