googleworkspace/cli

해결하는 문제

gws는 모든 Google Workspace API(Drive, Gmail, Calendar, Sheets 포함)와 상호 작용할 수 있는 통합된 방법을 제공하는 명령줄 인터페이스(CLI)입니다. Workspace 리소스를 관리할 때 복잡한 curl 호출이나 보일러플레이트 코드를 작성할 필요 없이, 이러한 서비스에 액세스할 수 있는 구조화되고 개발자 친화적인 방법을 제공합니다.

작동 방식

gws는 정적인 명령 목록을 포함하는 대신, Google의 Discovery Service를 읽어 실행 시점에 명령 표면을 동적으로 구축합니다. 이를 통해 Google이 새로운 API 엔드포인트나 메서드를 추가할 때마다 업데이트 없이도 CLI가 자동으로 이를 인식합니다. 서비스 식별 후 캐시된 Discovery Document를 기반으로 명령 트리를 구축하기 위해 2단계 파싱 전략을 사용합니다.

대상 사용자

• 개발자 및 파워 유저: 자동 페이지네이션, --dry-run 미리보기, 내장 도움말 등의 기능을 통해 터미널에서 Google Workspace를 관리하고자 하는 사용자.
• AI 에이전트: 모든 응답이 구조화된 JSON으로 제공되므로, 커스텀 통합 코드 없이도 LLM이 Workspace 작업을 관리할 수 있는 도구로 사용되도록 설계되었습니다.

주요 특징

• 동적 API 표면: Google의 Discovery Service를 기반으로 명령을 자동으로 업데이트합니다.
• AI 준비 완료: LLM이 일반적인 워크플로우를 수행할 수 있도록 100개 이상의 "Agent Skills"(큐레이션된 레시피 및 헬퍼)를 포함합니다.
• 구조화된 출력: 모든 성공 및 오류 응답은 파싱이 용이하도록 JSON으로 반환됩니다.
• 포괄적인 인증: 대화형 로그인, 서비스 계정, 사전 획득한 액세스 토큰을 포함한 다양한 인증 워크플로우를 지원합니다.
• 헬퍼 명령: 이메일 전송 또는 캘린더 이벤트 생성과 같은 일반적인 작업을 위한 특화된 사용자 친화적 단축키(+ 접두사)를 제공합니다.
• 보안 통합: Google Cloud Model Armor와 통합되어 API 응답이 에이전트에 도달하기 전에 프롬프트 인젝션 방지를 위해 정화(sanitize)됩니다.