챕터 13 · L1
Google Workspace CLI 설치 및 시작
gws(Google Workspace CLI) 설치, 인증, Drive·Docs·Sheets 첫 실행까지
Google Workspace CLI(gws)를 설치하고 Drive·Docs·Sheets를 터미널에서 첫 조회까지 할 수 있어요.
참고 문서
공개 문서
13. Google Workspace CLI 설치 및 시작
아래는 content/courses/13-google-workspace-cli-install.mdx 와 동일한 원문입니다. Markdown과 HTML 변환 결과를 각각 복사할 수 있습니다.
공개 문서 원문 (Markdown)
# Google Workspace CLI 설치 및 시작
> **이 챕터를 마치면** Google Workspace CLI(gws)를 설치하고 Drive·Docs·Sheets를 터미널에서 첫 조회까지 할 수 있어요.
Google Workspace CLI(**gws**)는 Google이 공개한 CLI 도구예요.
**Drive, Docs, Sheets, Gmail, Calendar, Chat** 등을 터미널에서 다루고, AI 에이전트와 연동할 수 있어요.
> **전제 조건:** Node.js 18+ 설치 완료 ([설치 챕터](./02-installation) 참고)
---
## 설치 (macOS 기준)
아래 순서대로 진행하면 **gws**와 **OAuth 인증**까지 한 번에 설정할 수 있어요.
### 1. Homebrew 설치 (이미 있으면 생략)
<div className="float-right w-full md:w-[40%] md:ml-6 mb-4 flex-shrink-0 not-prose">
<a href="https://brew.sh" target="_blank" rel="noopener noreferrer" className="block rounded-lg overflow-hidden border border-slate-200 shadow-sm hover:shadow-md transition-shadow">
<img src="/images/homebrew-install.png" alt="Homebrew 공식 사이트 — brew.sh" className="w-full h-auto" />
</a>
</div>
맥에서 패키지 관리자 Homebrew가 없다면 먼저 설치해요.
- **설치:** [https://brew.sh](https://brew.sh) 접속 후 안내되는 한 줄 명령 실행
또는 터미널에서:
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
- **확인:** `brew -v` → `Homebrew 5.x.x` 등 출력되면 성공
### 2. gws CLI 설치
<div className="float-right w-full md:w-[40%] md:ml-6 mb-4 flex-shrink-0 not-prose">
<a href="https://github.com/googleworkspace/cli" target="_blank" rel="noopener noreferrer" className="block rounded-lg overflow-hidden border border-slate-200 shadow-sm hover:shadow-md transition-shadow">
<img src="/images/gws-install.png" alt="Google Workspace CLI 공식 저장소 — github.com/googleworkspace/cli" className="w-full h-auto" />
</a>
</div>
터미널에서 전역 설치해요.
```bash
npm install -g @googleworkspace/cli
```
- **공식 저장소:** [github.com/googleworkspace/cli](https://github.com/googleworkspace/cli)
- **설치 확인:**
```bash
gws --version
# gws 0.x.x
```
### 3. gcloud CLI 설치 (OAuth 설정에 사용)
<div className="float-right w-full md:w-[40%] md:ml-6 mb-4 flex-shrink-0 not-prose">
<a href="https://cloud.google.com/sdk/docs/install" target="_blank" rel="noopener noreferrer" className="block rounded-lg overflow-hidden border border-slate-200 shadow-sm hover:shadow-md transition-shadow">
<img src="/images/gcloud-install.png" alt="Google Cloud SDK 설치 가이드 — cloud.google.com/sdk/docs/install" className="w-full h-auto" />
</a>
</div>
`gws auth setup`으로 OAuth 클라이언트를 만들려면 **Google Cloud SDK(gcloud)** 가 필요해요.
```bash
brew install --cask google-cloud-sdk
```
- **공식 설치 가이드:** [Google Cloud SDK 설치](https://cloud.google.com/sdk/docs/install)
- **설치 후 (선택):** 셸 자동완성·PATH 추가를 위해 터미널 프로필에 다음을 추가할 수 있어요.
```bash
# ~/.zshrc 또는 ~/.bash_profile
source "/usr/local/share/google-cloud-sdk/path.zsh.inc"
source "/usr/local/share/google-cloud-sdk/completion.zsh.inc"
```
추가 후 `source ~/.zshrc` 또는 새 터미널을 열어요.
- **확인:** `gcloud --version`
> **참고:** gcloud는 **gws auth setup** 단계에서만 사용해요. gws 명령만 쓸 때는 PATH에 없어도 돼요.
### 4. OAuth 설정 및 로그인
gws는 Google 계정(OAuth 2.0)으로 인증해요. 아래 중 **한 가지**를 선택해요.
#### 방법 A: gws auth setup + login (추천)
gcloud 설치가 끝났다면:
```bash
gws auth setup
```
대화형으로 GCP 프로젝트·OAuth 클라이언트를 설정한 뒤:
```bash
gws auth login
```
브라우저가 열리면 Google 계정으로 로그인하고 권한을 허용해요.
#### 방법 B: 수동 OAuth 클라이언트
gcloud 없이 진행하려면:
1. [Google Cloud Console](https://console.cloud.google.com/) → **API 및 서비스** → **사용자 인증 정보**
2. **사용자 인증 정보 만들기** → **OAuth 클라이언트 ID** (처음이면 동의 화면 구성 먼저)
3. 애플리케이션 유형: **데스크톱 앱** → **만들기** → **JSON 다운로드**
4. 다운로드한 파일을 gws 설정 경로에 복사해요.
```bash
mkdir -p ~/.config/gws
mv ~/Downloads/클라이언트파일이름.json ~/.config/gws/client_secret.json
```
5. 로그인:
```bash
gws auth login
```
#### 방법 C: 환경 변수로 지정
이미 **클라이언트 ID·시크릿**이 있다면:
```bash
export GOOGLE_WORKSPACE_CLI_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GOOGLE_WORKSPACE_CLI_CLIENT_SECRET="your-client-secret"
gws auth login
```
**이 프로젝트(skoolchef-tutorial)에 .env로 넣어둔 경우:** 프로젝트 루트에서 아래처럼 로드한 뒤 로그인할 수 있어요.
```bash
cd projects/skoolchef-tutorial
set -a && source .env && set +a
gws auth login
```
> `.env`는 Git에 올라가지 않도록 `.gitignore`에 포함되어 있어요. 클라이언트 시크릿은 공유·커밋하지 마세요.
**참고 링크 (설치용)**
| 용도 | 링크 |
|------|------|
| Homebrew 설치 | [https://brew.sh](https://brew.sh) |
| gws CLI 공식 저장소 | [github.com/googleworkspace/cli](https://github.com/googleworkspace/cli) |
| Google Cloud SDK(gcloud) 설치 | [cloud.google.com/sdk/docs/install](https://cloud.google.com/sdk/docs/install) |
| OAuth 클라이언트 만들기 (수동) | [Google Cloud Console → 사용자 인증 정보](https://console.cloud.google.com/apis/credentials) |
| gws 이슈/기능 요청 | [github.com/googleworkspace/cli/issues](https://github.com/googleworkspace/cli/issues) |
---
## 인증 확인
설치 및 OAuth 설정이 끝났다면:
```bash
gws auth login
```
브라우저가 열리며 Google 계정으로 로그인하고 권한을 허용하면 돼요.
이미 인증되어 있으면 "No OAuth client configured" 대신 정상 동작해요.
> **서비스 계정 (자동화·CI용):** Google Cloud Console에서 서비스 계정 키(JSON)를 발급한 뒤 `export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"` 로 사용할 수 있어요. 개인 학습·수동 작업은 위 OAuth 방법이면 충분해요.
---
## 첫 실행 — Drive 파일 목록
인증이 끝났다면 프로젝트 폴더나 아무 디렉터리에서:
```bash
gws drive files list
```
내 Drive의 최근 파일 목록이 터미널에 출력돼요.
```bash
# 특정 폴더 ID로 제한
gws drive files list --folder-id <folder-id>
# 10개만
gws drive files list --page-size 10
```
---
## Docs·Sheets 조회
### Google Docs 내용 가져오기
문서 ID는 [Google Docs](https://docs.google.com/document/) URL의 `/document/d/<doc-id>/edit` 부분에서 확인할 수 있어요.
```bash
# 문서 ID는 URL에서 확인: docs.google.com/document/d/<doc-id>/edit
gws docs get <doc-id>
```
문서 본문이 마크다운 형태로 출력돼요. 파이프로 다른 도구에 넘길 수 있어요.
```bash
gws docs get <doc-id> | head -50
```
### Google Sheets 데이터 가져오기
스프레드시트 ID는 [Google Sheets](https://docs.google.com/spreadsheets/) URL의 `/spreadsheets/d/<sheet-id>/edit` 부분에서 확인할 수 있어요.
```bash
# 스프레드시트 ID는 URL에서: docs.google.com/spreadsheets/d/<sheet-id>/edit
gws sheets get <sheet-id> --range "Sheet1!A1:D10"
```
---
## 실행 모드 정리
| 용도 | 명령 예시 |
|------|------------|
| Drive 파일 목록 | `gws drive files list` |
| Docs 본문 조회 | `gws docs get <doc-id>` |
| Sheets 범위 조회 | `gws sheets get <sheet-id> --range "A1:D10"` |
| 인증 | `gws auth login` |
| 도움말 | `gws --help`, `gws drive --help` |
---
## AI 도구와 파이프 연동
gws 출력을 Claude Code나 Gemini CLI에 넘기면 문서·데이터를 맥락으로 활용할 수 있어요.
```bash
# Docs 내용을 Claude Code에 전달해 요약
gws docs get <doc-id> | claude "이 문서를 3문장으로 요약해줘"
# Sheets 데이터를 Gemini에 전달해 분석
gws sheets get <sheet-id> --range "Sheet1!A1:Z100" | gemini "이 데이터의 패턴을 분석해줘"
```
---
## 다음 단계
설치와 첫 조회가 끝났다면 **기본 사용법과 Drive·Docs·Sheets 활용**을 배워봅시다.
---
## 9장 보강 프로세스 적용: gws 설치 운영 표준
9장 보강 템플릿을 13챕터에 동일 적용합니다. 핵심은 gws 설치보다 **인증·조회까지 한 번에 통과**하는 것입니다.
### 13챕터 실패 패턴 TOP 5
1. **OAuth 클라이언트 미설정**
- 대응: `gws auth setup` 또는 수동 클라이언트 구성 중 하나를 먼저 확정
2. **gcloud 경로 문제**
- 대응: `gcloud --version`으로 설치/경로 확인 후 진행
3. **잘못된 계정으로 인증**
- 대응: 실제 작업용 Google 계정으로 로그인 통일
4. **API 비활성 상태**
- 대응: 필요한 Workspace API 활성 여부 사전 확인
5. **인증 후 첫 조회 미실행**
- 대응: `gws drive files list`를 성공 기준으로 설정
### 13챕터 체크리스트 (DoD)
- [ ] `gws --version` 확인 완료
- [ ] OAuth 로그인 완료
- [ ] Drive 파일 조회 성공
- [ ] Docs 또는 Sheets 조회 1회 성공
- [ ] 인증 정보/시크릿이 Git 비추적 상태인지 확인 완료
> **다음 챕터 입력값:** 자주 쓰는 Drive query, Docs/Sheets 대상 ID, 파이프 분석 프롬프트공개 문서 변환 코드 (HTML)
<h1>Google Workspace CLI 설치 및 시작</h1>
<blockquote>
<p><strong>이 챕터를 마치면</strong> Google Workspace CLI(gws)를 설치하고 Drive·Docs·Sheets를 터미널에서 첫 조회까지 할 수 있어요.</p>
</blockquote>
<p>Google Workspace CLI(<strong>gws</strong>)는 Google이 공개한 CLI 도구예요.
<strong>Drive, Docs, Sheets, Gmail, Calendar, Chat</strong> 등을 터미널에서 다루고, AI 에이전트와 연동할 수 있어요.</p>
<blockquote>
<p><strong>전제 조건:</strong> Node.js 18+ 설치 완료 (<a href="./02-installation">설치 챕터</a> 참고)</p>
</blockquote>
<hr>
<h2>설치 (macOS 기준)</h2>
<p>아래 순서대로 진행하면 <strong>gws</strong>와 <strong>OAuth 인증</strong>까지 한 번에 설정할 수 있어요.</p>
<h3>1. Homebrew 설치 (이미 있으면 생략)</h3>
<div className="float-right w-full md:w-[40%] md:ml-6 mb-4 flex-shrink-0 not-prose">
<a href="https://brew.sh" target="_blank" rel="noopener noreferrer" className="block rounded-lg overflow-hidden border border-slate-200 shadow-sm hover:shadow-md transition-shadow">
<img src="/images/homebrew-install.png" alt="Homebrew 공식 사이트 — brew.sh" className="w-full h-auto" />
</a>
</div><p>맥에서 패키지 관리자 Homebrew가 없다면 먼저 설치해요.</p>
<ul>
<li><strong>설치:</strong> <a href="https://brew.sh">https://brew.sh</a> 접속 후 안내되는 한 줄 명령 실행<br>또는 터미널에서:<pre><code class="language-bash">/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
</code></pre>
</li>
<li><strong>확인:</strong> <code>brew -v</code> → <code>Homebrew 5.x.x</code> 등 출력되면 성공</li>
</ul>
<h3>2. gws CLI 설치</h3>
<div className="float-right w-full md:w-[40%] md:ml-6 mb-4 flex-shrink-0 not-prose">
<a href="https://github.com/googleworkspace/cli" target="_blank" rel="noopener noreferrer" className="block rounded-lg overflow-hidden border border-slate-200 shadow-sm hover:shadow-md transition-shadow">
<img src="/images/gws-install.png" alt="Google Workspace CLI 공식 저장소 — github.com/googleworkspace/cli" className="w-full h-auto" />
</a>
</div><p>터미널에서 전역 설치해요.</p>
<pre><code class="language-bash">npm install -g @googleworkspace/cli
</code></pre>
<ul>
<li><strong>공식 저장소:</strong> <a href="https://github.com/googleworkspace/cli">github.com/googleworkspace/cli</a> </li>
<li><strong>설치 확인:</strong><pre><code class="language-bash">gws --version
# gws 0.x.x
</code></pre>
</li>
</ul>
<h3>3. gcloud CLI 설치 (OAuth 설정에 사용)</h3>
<div className="float-right w-full md:w-[40%] md:ml-6 mb-4 flex-shrink-0 not-prose">
<a href="https://cloud.google.com/sdk/docs/install" target="_blank" rel="noopener noreferrer" className="block rounded-lg overflow-hidden border border-slate-200 shadow-sm hover:shadow-md transition-shadow">
<img src="/images/gcloud-install.png" alt="Google Cloud SDK 설치 가이드 — cloud.google.com/sdk/docs/install" className="w-full h-auto" />
</a>
</div><p><code>gws auth setup</code>으로 OAuth 클라이언트를 만들려면 <strong>Google Cloud SDK(gcloud)</strong> 가 필요해요.</p>
<pre><code class="language-bash">brew install --cask google-cloud-sdk
</code></pre>
<ul>
<li><strong>공식 설치 가이드:</strong> <a href="https://cloud.google.com/sdk/docs/install">Google Cloud SDK 설치</a></li>
<li><strong>설치 후 (선택):</strong> 셸 자동완성·PATH 추가를 위해 터미널 프로필에 다음을 추가할 수 있어요.<pre><code class="language-bash"># ~/.zshrc 또는 ~/.bash_profile
source "/usr/local/share/google-cloud-sdk/path.zsh.inc"
source "/usr/local/share/google-cloud-sdk/completion.zsh.inc"
</code></pre>
추가 후 <code>source ~/.zshrc</code> 또는 새 터미널을 열어요.</li>
<li><strong>확인:</strong> <code>gcloud --version</code></li>
</ul>
<blockquote>
<p><strong>참고:</strong> gcloud는 <strong>gws auth setup</strong> 단계에서만 사용해요. gws 명령만 쓸 때는 PATH에 없어도 돼요.</p>
</blockquote>
<h3>4. OAuth 설정 및 로그인</h3>
<p>gws는 Google 계정(OAuth 2.0)으로 인증해요. 아래 중 <strong>한 가지</strong>를 선택해요.</p>
<h4>방법 A: gws auth setup + login (추천)</h4>
<p>gcloud 설치가 끝났다면:</p>
<pre><code class="language-bash">gws auth setup
</code></pre>
<p>대화형으로 GCP 프로젝트·OAuth 클라이언트를 설정한 뒤:</p>
<pre><code class="language-bash">gws auth login
</code></pre>
<p>브라우저가 열리면 Google 계정으로 로그인하고 권한을 허용해요.</p>
<h4>방법 B: 수동 OAuth 클라이언트</h4>
<p>gcloud 없이 진행하려면:</p>
<ol>
<li><a href="https://console.cloud.google.com/">Google Cloud Console</a> → <strong>API 및 서비스</strong> → <strong>사용자 인증 정보</strong></li>
<li><strong>사용자 인증 정보 만들기</strong> → <strong>OAuth 클라이언트 ID</strong> (처음이면 동의 화면 구성 먼저)</li>
<li>애플리케이션 유형: <strong>데스크톱 앱</strong> → <strong>만들기</strong> → <strong>JSON 다운로드</strong></li>
<li>다운로드한 파일을 gws 설정 경로에 복사해요.<pre><code class="language-bash">mkdir -p ~/.config/gws
mv ~/Downloads/클라이언트파일이름.json ~/.config/gws/client_secret.json
</code></pre>
</li>
<li>로그인:<pre><code class="language-bash">gws auth login
</code></pre>
</li>
</ol>
<h4>방법 C: 환경 변수로 지정</h4>
<p>이미 <strong>클라이언트 ID·시크릿</strong>이 있다면:</p>
<pre><code class="language-bash">export GOOGLE_WORKSPACE_CLI_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GOOGLE_WORKSPACE_CLI_CLIENT_SECRET="your-client-secret"
gws auth login
</code></pre>
<p><strong>이 프로젝트(skoolchef-tutorial)에 .env로 넣어둔 경우:</strong> 프로젝트 루트에서 아래처럼 로드한 뒤 로그인할 수 있어요.</p>
<pre><code class="language-bash">cd projects/skoolchef-tutorial
set -a && source .env && set +a
gws auth login
</code></pre>
<blockquote>
<p><code>.env</code>는 Git에 올라가지 않도록 <code>.gitignore</code>에 포함되어 있어요. 클라이언트 시크릿은 공유·커밋하지 마세요.</p>
</blockquote>
<p><strong>참고 링크 (설치용)</strong></p>
<table>
<thead>
<tr>
<th>용도</th>
<th>링크</th>
</tr>
</thead>
<tbody><tr>
<td>Homebrew 설치</td>
<td><a href="https://brew.sh">https://brew.sh</a></td>
</tr>
<tr>
<td>gws CLI 공식 저장소</td>
<td><a href="https://github.com/googleworkspace/cli">github.com/googleworkspace/cli</a></td>
</tr>
<tr>
<td>Google Cloud SDK(gcloud) 설치</td>
<td><a href="https://cloud.google.com/sdk/docs/install">cloud.google.com/sdk/docs/install</a></td>
</tr>
<tr>
<td>OAuth 클라이언트 만들기 (수동)</td>
<td><a href="https://console.cloud.google.com/apis/credentials">Google Cloud Console → 사용자 인증 정보</a></td>
</tr>
<tr>
<td>gws 이슈/기능 요청</td>
<td><a href="https://github.com/googleworkspace/cli/issues">github.com/googleworkspace/cli/issues</a></td>
</tr>
</tbody></table>
<hr>
<h2>인증 확인</h2>
<p>설치 및 OAuth 설정이 끝났다면:</p>
<pre><code class="language-bash">gws auth login
</code></pre>
<p>브라우저가 열리며 Google 계정으로 로그인하고 권한을 허용하면 돼요.<br>이미 인증되어 있으면 "No OAuth client configured" 대신 정상 동작해요.</p>
<blockquote>
<p><strong>서비스 계정 (자동화·CI용):</strong> Google Cloud Console에서 서비스 계정 키(JSON)를 발급한 뒤 <code>export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"</code> 로 사용할 수 있어요. 개인 학습·수동 작업은 위 OAuth 방법이면 충분해요.</p>
</blockquote>
<hr>
<h2>첫 실행 — Drive 파일 목록</h2>
<p>인증이 끝났다면 프로젝트 폴더나 아무 디렉터리에서:</p>
<pre><code class="language-bash">gws drive files list
</code></pre>
<p>내 Drive의 최근 파일 목록이 터미널에 출력돼요.</p>
<pre><code class="language-bash"># 특정 폴더 ID로 제한
gws drive files list --folder-id <folder-id>
# 10개만
gws drive files list --page-size 10
</code></pre>
<hr>
<h2>Docs·Sheets 조회</h2>
<h3>Google Docs 내용 가져오기</h3>
<p>문서 ID는 <a href="https://docs.google.com/document/">Google Docs</a> URL의 <code>/document/d/<doc-id>/edit</code> 부분에서 확인할 수 있어요.</p>
<pre><code class="language-bash"># 문서 ID는 URL에서 확인: docs.google.com/document/d/<doc-id>/edit
gws docs get <doc-id>
</code></pre>
<p>문서 본문이 마크다운 형태로 출력돼요. 파이프로 다른 도구에 넘길 수 있어요.</p>
<pre><code class="language-bash">gws docs get <doc-id> | head -50
</code></pre>
<h3>Google Sheets 데이터 가져오기</h3>
<p>스프레드시트 ID는 <a href="https://docs.google.com/spreadsheets/">Google Sheets</a> URL의 <code>/spreadsheets/d/<sheet-id>/edit</code> 부분에서 확인할 수 있어요.</p>
<pre><code class="language-bash"># 스프레드시트 ID는 URL에서: docs.google.com/spreadsheets/d/<sheet-id>/edit
gws sheets get <sheet-id> --range "Sheet1!A1:D10"
</code></pre>
<hr>
<h2>실행 모드 정리</h2>
<table>
<thead>
<tr>
<th>용도</th>
<th>명령 예시</th>
</tr>
</thead>
<tbody><tr>
<td>Drive 파일 목록</td>
<td><code>gws drive files list</code></td>
</tr>
<tr>
<td>Docs 본문 조회</td>
<td><code>gws docs get <doc-id></code></td>
</tr>
<tr>
<td>Sheets 범위 조회</td>
<td><code>gws sheets get <sheet-id> --range "A1:D10"</code></td>
</tr>
<tr>
<td>인증</td>
<td><code>gws auth login</code></td>
</tr>
<tr>
<td>도움말</td>
<td><code>gws --help</code>, <code>gws drive --help</code></td>
</tr>
</tbody></table>
<hr>
<h2>AI 도구와 파이프 연동</h2>
<p>gws 출력을 Claude Code나 Gemini CLI에 넘기면 문서·데이터를 맥락으로 활용할 수 있어요.</p>
<pre><code class="language-bash"># Docs 내용을 Claude Code에 전달해 요약
gws docs get <doc-id> | claude "이 문서를 3문장으로 요약해줘"
# Sheets 데이터를 Gemini에 전달해 분석
gws sheets get <sheet-id> --range "Sheet1!A1:Z100" | gemini "이 데이터의 패턴을 분석해줘"
</code></pre>
<hr>
<h2>다음 단계</h2>
<p>설치와 첫 조회가 끝났다면 <strong>기본 사용법과 Drive·Docs·Sheets 활용</strong>을 배워봅시다.</p>
<hr>
<h2>9장 보강 프로세스 적용: gws 설치 운영 표준</h2>
<p>9장 보강 템플릿을 13챕터에 동일 적용합니다. 핵심은 gws 설치보다 <strong>인증·조회까지 한 번에 통과</strong>하는 것입니다.</p>
<h3>13챕터 실패 패턴 TOP 5</h3>
<ol>
<li><p><strong>OAuth 클라이언트 미설정</strong></p>
<ul>
<li>대응: <code>gws auth setup</code> 또는 수동 클라이언트 구성 중 하나를 먼저 확정</li>
</ul>
</li>
<li><p><strong>gcloud 경로 문제</strong></p>
<ul>
<li>대응: <code>gcloud --version</code>으로 설치/경로 확인 후 진행</li>
</ul>
</li>
<li><p><strong>잘못된 계정으로 인증</strong></p>
<ul>
<li>대응: 실제 작업용 Google 계정으로 로그인 통일</li>
</ul>
</li>
<li><p><strong>API 비활성 상태</strong></p>
<ul>
<li>대응: 필요한 Workspace API 활성 여부 사전 확인</li>
</ul>
</li>
<li><p><strong>인증 후 첫 조회 미실행</strong></p>
<ul>
<li>대응: <code>gws drive files list</code>를 성공 기준으로 설정</li>
</ul>
</li>
</ol>
<h3>13챕터 체크리스트 (DoD)</h3>
<ul>
<li><input disabled="" type="checkbox"> <code>gws --version</code> 확인 완료</li>
<li><input disabled="" type="checkbox"> OAuth 로그인 완료</li>
<li><input disabled="" type="checkbox"> Drive 파일 조회 성공</li>
<li><input disabled="" type="checkbox"> Docs 또는 Sheets 조회 1회 성공</li>
<li><input disabled="" type="checkbox"> 인증 정보/시크릿이 Git 비추적 상태인지 확인 완료</li>
</ul>
<blockquote>
<p><strong>다음 챕터 입력값:</strong> 자주 쓰는 Drive query, Docs/Sheets 대상 ID, 파이프 분석 프롬프트</p>
</blockquote>