5장 GWS CLI (문서)

---
moduleId: m4
toolKey: workspace-cli
title: 4장. GWS CLI
sourceTsx: /projects/ai-coding-tools/hub/curriculum/m4
---

# 4장. GWS CLI

Google Workspace CLI를 팀 문서 자동화에 활용하기 위한 설치, 업데이트 추적 기준, 핵심 기능 5가지를 정리합니다.

> 인터랙티브 커리큘럼(TSX): [/projects/ai-coding-tools/hub/curriculum/m4](/projects/ai-coding-tools/hub/curriculum/m4)

## 개요

- **부제**: 인증 · 가이드
- **섹션**: Workspace CLI Reference View

## 설치 (macOS 요약)

- 1. **Google Cloud 프로젝트 및 Workspace API 권한 준비** — Cloud Console에서 프로젝트 생성 후 Drive/Docs/Sheets API를 활성화하고 OAuth 동의 화면을 구성합니다.
- 2. **GWS CLI 설치 후 OAuth 인증 설정** — CLI 설치 후 OAuth 클라이언트 연결, 로그인, 토큰 저장 경로까지 확인합니다.
- 3. **Drive/Docs/Sheets 명령 동작 테스트** — 파일 목록 조회, 문서 생성, 시트 읽기/쓰기 테스트로 API 스코프와 권한을 검증합니다.
- 4. **팀 문서 자동화 시나리오에 연결** — 주간 보고서 생성, 회의록 정리, 업무 시트 업데이트 등 실제 팀 자동화 흐름에 연결합니다.

## 최근 업데이트

- 2026-04-10 — **Chat API 메시지 액션 Developer Preview**: 메시지 컨텍스트 메뉴에서 Chat 앱 동작을 호출할 수 있는 액션 기능이 프리뷰로 공개되었습니다.
- 2026-04-02 — **Meet API Smart Notes GA**: smart notes 조회/구독 이벤트(started, ended, fileGenerated)가 정식 지원되었습니다.
- 2026-04-01 — **Chat 커스텀 섹션 GA**: 대화 섹션 생성/삭제/업데이트/정렬 API가 정식 지원되어 정보 구조화 자동화가 쉬워졌습니다.

## 핵심 기능

### Cloud/OAuth Setup 안정화

GWS CLI 시작 단계에서 권한·OAuth·토큰 흐름 먼저 고정

- 시나리오: 팀 계정으로 처음 연동할 때

### Drive 자동화 루틴

업로드·검색·권한 설정 루틴화로 반복 업무 감소

- 시나리오: 주간 산출물을 Drive에 자동 정리할 때

### Docs 생성/편집 자동화

반복 문서 작업을 템플릿 기반 자동 생성·갱신

- 시나리오: 회의록/주간 리포트 초안을 자동으로 만들 때

### Sheets 지표 갱신 루프

시트 읽기/쓰기 자동화로 대시보드 업데이트 안정화

- 시나리오: 매일 KPI 시트를 수동으로 갱신하고 있을 때

### 실제 사례) 문서-코드 동기화 스프린트

Workspace 문서 자동화 + 코딩 도구로 요구-구현 동기화(실전)

- 시나리오: 요구사항 문서와 구현 상태를 동시에 맞춰야 할 때

## 공식 링크

- [Google Workspace Developers](https://developers.google.com/workspace)
- [내부 인증/검증 가이드](/skoolchef-files/docs/gws-auth-and-verified-usage.md)

## 링크 정책

허브 상단 4개 도구 버튼은 학습 흐름 고정을 위해 각각 m1~m4 내부 서브페이지로 이동합니다. 이 화면의 공식 링크는 참고 자료로 별도 제공합니다.

<hr>
<h2>moduleId: m4
toolKey: workspace-cli
title: 4장. GWS CLI
sourceTsx: /projects/ai-coding-tools/hub/curriculum/m4</h2>
<h1>4장. GWS CLI</h1>
<p>Google Workspace CLI를 팀 문서 자동화에 활용하기 위한 설치, 업데이트 추적 기준, 핵심 기능 5가지를 정리합니다.</p>
<blockquote>
<p>인터랙티브 커리큘럼(TSX): <a href="/projects/ai-coding-tools/hub/curriculum/m4">/projects/ai-coding-tools/hub/curriculum/m4</a></p>
</blockquote>
<h2>개요</h2>
<ul>
<li><strong>부제</strong>: 인증 · 가이드</li>
<li><strong>섹션</strong>: Workspace CLI Reference View</li>
</ul>
<h2>설치 (macOS 요약)</h2>
<ul>
<li><ol>
<li><strong>Google Cloud 프로젝트 및 Workspace API 권한 준비</strong> — Cloud Console에서 프로젝트 생성 후 Drive/Docs/Sheets API를 활성화하고 OAuth 동의 화면을 구성합니다.</li>
</ol>
</li>
<li><ol start="2">
<li><strong>GWS CLI 설치 후 OAuth 인증 설정</strong> — CLI 설치 후 OAuth 클라이언트 연결, 로그인, 토큰 저장 경로까지 확인합니다.</li>
</ol>
</li>
<li><ol start="3">
<li><strong>Drive/Docs/Sheets 명령 동작 테스트</strong> — 파일 목록 조회, 문서 생성, 시트 읽기/쓰기 테스트로 API 스코프와 권한을 검증합니다.</li>
</ol>
</li>
<li><ol start="4">
<li><strong>팀 문서 자동화 시나리오에 연결</strong> — 주간 보고서 생성, 회의록 정리, 업무 시트 업데이트 등 실제 팀 자동화 흐름에 연결합니다.</li>
</ol>
</li>
</ul>
<h2>최근 업데이트</h2>
<ul>
<li>2026-04-10 — <strong>Chat API 메시지 액션 Developer Preview</strong>: 메시지 컨텍스트 메뉴에서 Chat 앱 동작을 호출할 수 있는 액션 기능이 프리뷰로 공개되었습니다.</li>
<li>2026-04-02 — <strong>Meet API Smart Notes GA</strong>: smart notes 조회/구독 이벤트(started, ended, fileGenerated)가 정식 지원되었습니다.</li>
<li>2026-04-01 — <strong>Chat 커스텀 섹션 GA</strong>: 대화 섹션 생성/삭제/업데이트/정렬 API가 정식 지원되어 정보 구조화 자동화가 쉬워졌습니다.</li>
</ul>
<h2>핵심 기능</h2>
<h3>Cloud/OAuth Setup 안정화</h3>
<p>GWS CLI 시작 단계에서 권한·OAuth·토큰 흐름 먼저 고정</p>
<ul>
<li>시나리오: 팀 계정으로 처음 연동할 때</li>
</ul>
<h3>Drive 자동화 루틴</h3>
<p>업로드·검색·권한 설정 루틴화로 반복 업무 감소</p>
<ul>
<li>시나리오: 주간 산출물을 Drive에 자동 정리할 때</li>
</ul>
<h3>Docs 생성/편집 자동화</h3>
<p>반복 문서 작업을 템플릿 기반 자동 생성·갱신</p>
<ul>
<li>시나리오: 회의록/주간 리포트 초안을 자동으로 만들 때</li>
</ul>
<h3>Sheets 지표 갱신 루프</h3>
<p>시트 읽기/쓰기 자동화로 대시보드 업데이트 안정화</p>
<ul>
<li>시나리오: 매일 KPI 시트를 수동으로 갱신하고 있을 때</li>
</ul>
<h3>실제 사례) 문서-코드 동기화 스프린트</h3>
<p>Workspace 문서 자동화 + 코딩 도구로 요구-구현 동기화(실전)</p>
<ul>
<li>시나리오: 요구사항 문서와 구현 상태를 동시에 맞춰야 할 때</li>
</ul>
<h2>공식 링크</h2>
<ul>
<li><a href="https://developers.google.com/workspace">Google Workspace Developers</a></li>
<li><a href="/skoolchef-files/docs/gws-auth-and-verified-usage.md">내부 인증/검증 가이드</a></li>
</ul>
<h2>링크 정책</h2>
<p>허브 상단 4개 도구 버튼은 학습 흐름 고정을 위해 각각 m1~m4 내부 서브페이지로 이동합니다. 이 화면의 공식 링크는 참고 자료로 별도 제공합니다.</p>