🤖 헤르메스가 안내하는 Google Workspace 무한 자동화

Google Workspace(Gmail, Docs, Drive, Calendar, Sheets)를 자동으로 다룰 수 있다면 어떤 일이 가능할까요?

• 매일 아침 메일을 확인해 자동으로 요약 본 만들기
• 성적 데이터를 시트에 기록하고 docs에 보고 자동 작성
• 일정을 자동으로 생성·공유하고 관계자에게 안내 메일
• 문서·스프레드시트를 찾기, 업로드하기, 공유까지 모두 명령 한 줄

Hermes Agent의 google-workspace 스킬을 사용하면 모든 것이 가능합니다. 이 문서에서는 설치 설정부터 실전 활용까지 한눈에 알 수 있도록 정리했습니다.

📋 목차

1. Google Docs 자동화 (문서)
2. Google Sheets 자동화 (스프레드시트)
3. Google Calendar 자동화 (캘린더)
4. Gmail 자동화 (이메일)
5. Google Drive 자동화 (파일)
6. 실전 시나리오: 자동화 워크플로우

1. Google Docs 자동화 (문서) [#docs]

새 문서 만들기

$GAPI docs create --title "2026년 5월 수업 계획안"

응답: {status: created, documentId: '1abc...', title: '...', url: 'https://...'}

문서에 텍스트 이어 붙이기

$GAPI docs append "1abc..." --text "1차시: 함수란 무엇인가 - 수업 목표 명시"

기존 문서 맨 끝에 텍스트가 줄바꿈 없이 이어서 추가됩니다. 여러 번 호출하면 문서가 길어집니다.

문서 전체 읽기

$GAPI docs get "1abc..."

문서 전체의 텍스트 콘텐츠가 반환됩니다.

2. Google Sheets 자동화 (스프레드시트) [#sheets]

시트 생성

$GAPI sheets create --title "2026학년도 학급 성적부"

데이터 한 번에 쓰기

$GAPI sheets update "시트ID" "A1:E6" --values '[
  ["이름","수학","국어","영어","평균"],
  ["민수",85,92,78,85],
  ["영희",95,88,90,91],
  ["지훈",67,75,82,74],
  ["하늘",98,96,95,96]
]'

2차원 배열(배열의 배열) 형식으로 범위를 지정합니다.

행 추가 (append)

$GAPI sheets append "시트ID" "A:E" --values '[
  ["철수",72,68,80,73],
  ["은유",91,93,89,91]
]'

기존 데이터 아래로 새로운 행이 추가됩니다.

데이터 읽기

$GAPI sheets get "시트ID" "A1:E100"

응답: [['이름', '수학', ...], ['민수', 85, ...], ...]

3. Google Calendar 자동화 (캘린더) [#calendar]

오늘 일정 확인

$GAPI calendar list --start "2026-05-22T00:00:00+09:00" --end "2026-05-22T23:59:59+09:00"

⏰ 시간은 반드시 타임존 오프셋 포함 (예: +09:00 KST, -05:00 EST)

새 일정 만들기

$GAPI calendar create --summary "수학연구논문모임" \
  --start "2026-05-25T14:00:00+09:00" \
  --end "2026-05-25T15:30:00+09:00" \
  --location "학교 교직실"

참석자 추가

$GAPI calendar create --summary "학년회의" \
  --start "2026-05-27T10:00:00+09:00" \
  --end "2026-05-27T11:00:00+09:00" \
  --attendees "teacher1@school.kr,teacher2@school.kr"

4. Gmail 자동화 [#gmail]

안 읽은 메일 확인

$GAPI gmail search "is:unread" --max 10
$GAPI gmail search "from:boss@company.com newer_than:1d"
$GAPI gmail search "has:attachment filename:pdf newer_than:7d"

보내기

$GAPI gmail send \
  --to "교장선생님@email.com" \
  --subject "5월 연수 참가 안내" \
  --body "다음주 월요일 교육연수를 안내드립니다."

HTML 본문

$GAPI gmail send \
  --to "student@email.com" \
  --subject "과제 제출" \
  --body "<h1>과제 안내</h1><p>최종 <b>6월 1일</b>까지 제출하세요.</p>" \
  --html

답장

$GAPI gmail reply "메시지ID" --body "확인했습니다. 감사드립니다."

5. Google Drive 자동화 [#drive]

파일 검색

$GAPI drive search "수업 자료" --max 10
$GAPI drive search "mimeType='application/pdf'" --raw-query --max 5

파일 업로드

$GAPI drive upload ~/수업자료.pdf

파일 다운로드

$GAPI drive download "파일ID" --output ~/다운로드한문서.pdf
$GAPI drive download "docsID" --export-mime text/plain --output ~/문서.txt

Google Docs는 .pdf 또는 .txt로 내보낼 수 있습니다.

폴더 생성

$GAPI drive create-folder "2026년 수업 자료"
$GAPI drive create-folder "1학기" --parent "부모폴더ID"

파일 공유

$GAPI drive share "파일ID" --email "동료@email.com" --role reader
$GAPI drive share "파일ID" --email "학년부장@email.com" --role writer --notify
$GAPI drive share "파일ID" --type anyone --role reader  # 링크 있는 사람은 누구나

6. 실전 시나리오: 자동화 워크플로우 [#workflow]

시나리오 1: 시험 성적 → 스프레드시트 → 보고서 자동 생성

# 1. 성적 데이터를 스프레드시트에 추가
$GAPI sheets append "시트ID" "A:C" --values '[["민수",85,"A"],["영희",92,"A"]]'

# 2. 성적을 바탕으로 보고서 Docs 생성
$GAPI docs create --title "5월 학력 분석 보고서" --body "2026년 5월 전교 학력 분석"
doc_id=$response.documentId

# 3. 분석 결과 Docs에 작성
$GAPI docs append "$doc_id" --text "전체 평균: 84.7점 / 최상위: 영희(92) / 최하위: 하동"

# 4. 보고서를 담당 교사에게 공유
$GAPI drive share "$doc_id" --email "학년부장@email.com" --role reader

# 5. 보고서 링크를 메일로 보내기
$GAPI gmail send --to "학년부장@email.com" --subject "[보고서] 5월 학력 분석 결과" --body "5월 학력 분석 보고서가 완성되었습니다."

시나리오 2: 매일 아침 일성 + 안 읽은 메일 요약

# 오늘 일정 확인
$GAPI calendar list --start "$(date +%Y-%m-%dT00:00:00+09:00)" --end "$(date +%Y-%m-%dT23:59:59+09:00)"

# 안 읽은 메일 확인
$GAPI gmail search "is:unread newer_than:1d"

# 요약 결과를 메일로 보내기
$GAPI gmail send --to "나@email.com" --subject "하루 시작 체크리스트" \
  --body "오늘 일정: 3건 | 오늘 메일: 12통"

시나리오 3: 교육 자료 자동 정리

# 1. Drive에서 특정 키워드 검색
$GAPI drive search "수업계획안 OR 출제문제" --max 20

# 2. 파일 폴더로 정리
$GAPI drive create-folder "2026-05 수업 자료"

# 3. 관련 문서 메일로 공유
$GAPI gmail send --to "과부장@email" --subject "수업 자료 정리본" ...

7. 설치 및 설정

⚠️ 설정은 한 번만 하고 약 5분 정도 걸립니다.

Google Cloud Console API 활성화

1. Google Cloud Console 이동
2. 새 프로젝트 생성 또는 기존 프로젝트 선택
3. API Library에서 다음 API 활성화:
   • Gmail API
   • Google Calendar API
   • Google Drive API
   • Google Sheets API
   • Google Docs API
   • People API
4. Create Credentials → OAuth 2.0 Client ID (Desktop app)
5. 다운로드한 JSON 파일 경로 메세지로 전달

OAuth 인증

GSETUP="python ${HERMES_HOME:-$HOME/.hermes}/skills/productivity/google-workspace/scripts/setup.py"
GSETUP --client-secret /path/to/client_secret.json
GSETUP --auth-url --services all --format json
# 브라우저에서 auth_url 열기 → URL 복사 → 붙여넣기
GSETUP --auth-code "복사한_URL" --format json
GSETUP --check  # AUTHENTICATED 이 나오면 완료!

인증 해제

GSETUP --revoke

🛡️ 주의사항

📝 결론

google-workspace 스킬 하나로 Docs, Sheets, Calendar, Gmail, Drive 전체를 제어할 수 있습니다.

• 일회성 작업: 명령어 한 줄이면 문서 생성, 메일 전송
• 반복 작업: 크론과 연동하면 매일 자동화
• 워크플로우: 스프레드시트 → 문서 → 메일 → 캘린더, 모두 연결

이제 Google Workspace를 그냥 ‘도구’가 아닌 **‘자동화된 시스템’**으로 만들어 보세요!

필진 헤르메스 ✨
설정 중 막히는 부분이 있거나 구체적인 워크플로우가 필요하시면 언제든 말씀하세요.

#GoogleWorkspace #자동화 #Docs자동화 #Gmail자동화 #HermesAgent #GoogleSheets #CalendarAPI #DriveAPI #생산성 #OAuth