Workspace CLI Reference View

4장. GWS CLI

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

설치 단계

4

업데이트 소스

2

핵심 기능

8

권장 레벨

L1-L2

섹션인증 · 가이드

1. 설치 및 시작하기

☁️ 1단계

Google Cloud 프로젝트 및 Workspace API 권한 준비

Cloud Console에서 프로젝트 생성 후 Drive/Docs/Sheets API를 활성화하고 OAuth 동의 화면을 구성합니다.

  1. 1) Cloud 프로젝트 생성
  2. 2) Drive/Docs/Sheets API 활성화
  3. 3) OAuth 동의 화면/테스트 사용자 설정

초보자용 권한 준비 요약

  • • API 활성화와 OAuth 화면 설정은 반드시 함께 진행해야 합니다.
  • • 테스트 사용자 미등록 시 인증 단계에서 막힐 수 있습니다.
  • • 스코프는 처음엔 최소 권한으로 시작하고 필요한 만큼만 확장하세요.
Workspace API 시작 문서
🔑 2단계

GWS CLI 설치 후 OAuth 인증 설정

CLI 설치 후 OAuth 클라이언트 연결, 로그인, 토큰 저장 경로까지 확인합니다.

  1. 1) GWS CLI 설치
  2. 2) OAuth 클라이언트 연결 및 로그인
  3. 3) 액세스/리프레시 토큰 저장·갱신 확인

초보자용 인증 설정 요약

  • • 인증이 성공해도 토큰 저장 위치가 잘못되면 재실행마다 실패할 수 있습니다.
  • • 팀 공용 PC에서는 토큰 파일 권한 관리가 중요합니다.
  • • 토큰 만료 시 재인증 흐름을 미리 점검해 두면 운영이 안정적입니다.
OAuth 공식 가이드
🧪 3단계

Drive/Docs/Sheets 명령 동작 테스트

파일 목록 조회, 문서 생성, 시트 읽기/쓰기 테스트로 API 스코프와 권한을 검증합니다.

🧩 4단계

팀 문서 자동화 시나리오에 연결

주간 보고서 생성, 회의록 정리, 업무 시트 업데이트 등 실제 팀 자동화 흐름에 연결합니다.

2. 최근 업데이트 내역

출처: Google Workspace Developer Release Notes검증일 2026-04-15자동 점검 통과 · 14일 기준자세히 보기

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가 정식 지원되어 정보 구조화 자동화가 쉬워졌습니다.

3. 핵심 기능 8가지

비개발자 학습 순서에 맞춰 기초 → 심화 → 실제 사례 구성으로 정리했습니다. 항목을 눌러 상세를 펼칠 수 있습니다.

맥락

입문 가이드에서 API 활성화·OAuth 세팅을 첫 난관으로 공통 강조

인증은 되는데 명령 실행마다 권한 오류가 발생할 때

설명

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

팀 계정으로 처음 연동할 때

실행 단계

  • 프로젝트 API 활성화 상태 먼저 점검
  • OAuth 동의 화면·테스트 사용자 설정 확인
  • 토큰 저장 위치·갱신 흐름 검증

결과

초기 인증 장애 감소, 자동화 작업으로 빠른 전환

주의

권한 스코프를 넓게 잡으면 보안·승인 절차 장기화

바로 실행

GWS OAuth 설정 점검표를 최소 권한 기준으로 만들어줘

참조 링크

맥락

실무에서 Drive 정리·공유 자동화가 체감 효과 가장 큼

파일은 쌓이는데 공유 권한과 폴더 규칙이 매번 달라질 때

설명

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

주간 산출물을 Drive에 자동 정리할 때

실행 단계

  • 폴더 구조·파일명 규칙 먼저 고정
  • 업로드 후 권한 부여 단계 자동화
  • 완료 로그로 누락 파일 확인

결과

공유 누락·폴더 혼선 감소, 운영 품질 향상

주의

권한 단계를 자동화에서 빼면 보안 사고·누락 위험

바로 실행

Drive 업로드+권한 부여+로그까지 한 번에 실행 흐름으로 정리해줘

참조 링크

허브 버튼 링크 기준

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

Google Workspace Developers내부 인증/검증 가이드
타임라인으로 돌아가기