gog — единый Go CLI для Google Workspace

источник ↗ ·

Один бинарник Go, дающий унифицированный CLI-доступ ко всем основным сервисам Google Workspace и API с безопасным выводом JSON/TSV для скриптов, CI и агентов.

go-cli google-workspace automation json-output oauth admin-sdk agent-tools mcp-server

privacy

Эта заметка участвует в semantic memory.

AI Summary

  1. Краткий обзор сути: gog — это единый Go CLI, который объединяет Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Apps Script, Contacts, Tasks и Workspace Admin в одном бинарнике, ориентированном на терминалы, скрипты, CI и coding-агентов.

  2. Ключевые тезисы: • Один бинарник даёт доступ ко всем перечисленным сервисам. • Стабильный вывод: --json (stdout) и --plain TSV; человекочитаемый вывод всегда идёт в stderr. • Runtime discovery через gog schema --json раскрывает структуру команд, exit codes и safety state. • Поддержка множества аккаунтов и клиентов (OAuth, access tokens, ADC, service accounts). • Единый контракт автоматизации для людей, скриптов и агентов с non-interactive режимом, стабильными exit codes и safety profiles. • Preview-first аудиты: tree, du, inventory; Contacts dedupe требует --apply для применения изменений. • Сгенерированная документация и MCP server для typed allowlisted инструментов.

  3. Важные детали и нюансы: • Команды: gog gmail search 'newer_than:7d' --max 10, gog gmail get --sanitize-content --json, gog calendar events --today, gog --account admin@example.com admin users create …, gog drive tree --parent --depth 2, gog docs format --match Status --bold, gog sheets table append Tasks 'Ship README|done', gog slides create-from-markdown … • Поддерживаемые сервисы: Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Apps Script, Contacts, People, Tasks, Classroom, Chat, Groups, Keep, Workspace Admin, YouTube, Photos. • Безопасность: read-only enforcement, untrusted-content wrapping, command guards, baked safety profiles; raw API JSON dumps не меняют состояние. • Конфигурация: GOG_HOME, XDG paths, domain-wide delegation, service accounts. • Дополнительно: MCP server, polling Drive/Docs с курсорами и shell hooks, Google Docs request batches с recovery, live testing suite.

  4. Практические выводы/следующие шаги: установить через brew install → Quickstart (5 минут), изучить Why gog и Automation/Safety Profiles, сгенерировать MCP tools, настроить Workspace Admin через service accounts и domain-wide delegation, использовать gog backup push для бэкапа, следить за changelog и spec (цели/не-цели).

Мои мысли

graph

Карта связей