gog

gog 工具為與 Google Workspace 生態系統互動提供了強大的命令列介面。專為進階使用者、開發者與自動化工程師設計，簡化了 Gmail、Google 行事曆、雲端硬碟、聯絡人、Google 試算表與 Google 文件的互動。透過提供這些服務的程式化存取能力，使用者可以繞過網頁介面，直接從終端機或自動化代理工作流程中執行複雜任務、批次作業與系統整合。

• 執行精細的 Gmail 操作，包括搜尋郵件串或個別郵件、發送純文字或 HTML 郵件、管理草稿以及處理帶有郵件串 ID 的回覆。

• 管理 Google 行事曆活動，包含精準的時間規劃、建立活動、更新活動細節、設定自訂顏色以及查詢特定時間範圍內的行程。

• 透過進階搜尋功能簡化 Google 雲端硬碟的檔案操作。

• 在 Google 試算表中執行資料密集型操作，例如以 JSON 格式讀取儲存格範圍、執行批次更新、附加新列以及清除特定資料範圍。

• 存取並匯出 Google 文件內容至本地檔案，支援快速檢索與文件處理工作流程。

• 使用 OAuth 流程簡化認證管理，針對各種服務提供安全的跨帳號支援。

• 需要使用用戶端憑證進行初始 OAuth 設定，並針對每個帳號進行明確的服務授權。

• 建議優先使用純文字郵件以確保相容性，針對多段落內容可使用 body-file 參數，或使用標準輸入 (stdin) 進行管道傳輸。

• 將 gog 整合至指令稿時，建議使用 --json 與 --no-input 旗標，確保輸出結果與標準處理工具相容。

• 利用 GOG_ACCOUNT 等環境變數來維護持續性的帳號上下文，減少重複執行指令時所需的參數輸入。

• 請注意，Google 文件的複雜原地編輯受 API 限制，建議優先使用匯出與讀取功能而非直接修改。

• 在部署發送郵件或修改行事曆活動的自動化指令稿前，請確保包含手動確認步驟或進行乾運行測試。