---
title: "GOG CLI 安装配置指南"
type: source
tags: [gog, gog-cli, macos, google-workspace, oauth]
date: 2026-03-15
---

## Source File
- [[raw/Skills/GOG-CLI-安装配置指南.md]]

## Summary（用中文描述）
- 核心主题：gog CLI 工具在 macOS 上的完整安装与配置流程
- 问题域：Google Workspace（Gmail、Google Calendar、Google Drive、Google Contacts、Google Docs、Google Sheets）的命令行管理
- 方法/机制：通过 Homebrew 安装 → Google Cloud Console 创建 OAuth 凭证 → 配置凭证文件 → 添加测试用户绕过 Google 安全验证 → 启用各 Google API → 验证授权
- 结论/价值：实现通过命令行高效管理 Google Workspace 全套服务，支持搜索邮件、发送邮件、管理日历、搜索 Drive 文件、操作 Sheets/Docs 等功能

## Key Claims（用中文描述）
- 通过 Homebrew 安装 gog CLI 是最简方式，安装路径为 /opt/homebrew/bin/gog
- Google API 调用需同时满足 OAuth 授权和 API Enablement 两层条件，缺一不可
- 对于未经 Google 验证的应用，通过在 OAuth 客户端中添加测试用户可绕过"此应用未经 Google 验证"的安全限制
- 启用新 API 服务后需重新授权（revoke + login），否则旧 token 不包含新权限会导致 403 错误
- 设置 GOG_ACCOUNT 环境变量可避免每次命令都需指定账号

## Key Quotes
> "此应用未经 Google 验证。此应用请求访问您 Google 账号中的敏感信息。在开发者让该应用通过 Google 验证之前，请勿使用该应用。" — 首次授权时的典型 Google 安全警告
> "即使 OAuth 成功，如果 API 未启用也会报错：403 accessNotConfigured" — OAuth 与 API Enablement 的两层机制说明
> "gog auth revoke → gog auth login：旧 token 不包含新权限" — 启用新 API 后的必要重新授权步骤

## Key Concepts
- [[OAuth 2.0]]：Google API 的用户身份认证机制，gog 通过 OAuth 让用户授权 CLI 访问其 Google 账号数据
- [[Google Cloud Console]]：Google 云平台控制台，用于创建 OAuth 凭证和启用 Google API 服务
- [[Google Workspace]]：Google 生产力工具套件，包含 Gmail、Google Calendar、Google Drive、Google Contacts、Google Docs、Google Sheets
- [[Homebrew]]：macOS 包管理器，gog CLI 通过 `brew install steipete/tap/gogcli` 安装

## Key Entities
- [[steipete]]：gogcli 项目的开发者，维护 gog CLI 工具
- [[ishenwei@gmail.com]]：配置中使用的 Google 账号，通过该账号授权 gog 访问 Google Workspace

## Connections
- [[Homebrew]] ← 安装工具 ← [[GOG CLI 安装配置指南]]
- [[Google Workspace]] ← 管理对象 ← [[GOG CLI 安装配置指南]]
- [[OAuth 2.0]] ← 认证机制 ← [[GOG CLI 安装配置指南]]
- [[Google Cloud Console]] ← 配置平台 ← [[GOG CLI 安装配置指南]]

## Contradictions
- 暂无已知冲突内容