Thanawat Wongchai

Posted on Mar 17 • Originally published at apidog.com

วิธีใช้ Google Workspace CLI: คู่มือฉบับสมบูรณ์

#automation #cli #google #tutorial

Google Workspace CLI (เรียกใช้ในชื่อ gws) คืออะไร?

Google Workspace CLI (gws) เป็นเครื่องมือบรรทัดคำสั่งโอเพนซอร์สที่ช่วยให้นักพัฒนาและ AI agent เข้าถึง Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin และ Workspace API อื่นๆ ได้จากเครื่องมือเดียว โดยอาศัย Google Discovery Service เพื่ออัปเดตคำสั่งอัตโนมัติแบบสด ไม่ต้องอัปเดตโค้ดเอง ติดตั้งผ่าน npm, ยืนยันตัวตนด้วย OAuth เพียงครั้งเดียว และสามารถเชื่อมต่อกับ agent เช่น Claude Code หรือ Cursor ได้ทันที ไม่ต้องจัดการ OAuth flow หรือ SDK หลายตัว

ทดลองใช้ Apidog วันนี้

ทำไม Google Workspace CLI ถึงสำคัญ?

นักพัฒนาและผู้ใช้งานมักต้องการอัตโนมัติหรือดึงข้อมูลจากบริการ Google Workspace เช่น Drive, Gmail, Calendar, Sheets ฯลฯ แต่ต้องเขียนสคริปต์ curl เอง, จัดการ OAuth scopes, handle pagination หรือใช้ SDK ที่ล้าสมัย ซึ่งยุ่งยากและเสี่ยงต่อข้อผิดพลาด

Google Workspace CLI แก้ปัญหานี้ด้วย CLI เดียวที่ขับเคลื่อนด้วย Rust ค้นพบ Workspace API ทั้งหมดแบบไดนามิก ตารางคำสั่งจึงอัปเดตตรงกับ API ล่าสุดทันทีโดยไม่ต้องรอ release ใหม่

จุดเด่น:

ผลลัพธ์ JSON สะอาด
รองรับ dry-run, pagination helpers
มี shortcut 40+ แบบ เช่น gws gmail +send หรือ gws calendar +agenda
พร้อมทักษะสำหรับ agent (Claude, Cursor, Gemini CLI ฯลฯ) ไม่ต้องเขียน custom integration

หากต้องการทดสอบ API ควบคู่กับการอัตโนมัติ Apidog จะทำหน้าที่เป็น API client สำหรับตรวจสอบ, ส่งคำขอ, จัดการ environment และรัน test suite ร่วมกับ Google Workspace CLI เพื่อให้มั่นใจว่า integration ทำงานถูกต้อง

การติดตั้ง Google Workspace CLI

ข้อกำหนด: Node.js 18 ขึ้นไป

ตรวจสอบเวอร์ชัน:

node --version

รันโดยไม่ต้องติดตั้ง

ทดลองใช้งานผ่าน npx ทันที:

npx @googleworkspace/cli --help
npx @googleworkspace/cli drive files list --params '{"pageSize":1}'

เหมาะกับการทดสอบหรือสคริปต์ชั่วคราว

ติดตั้งทั่วโลก

ติดตั้ง CLI ให้พร้อมใช้งานทุกที่:

npm install -g @googleworkspace/cli
gws --version

Google Workspace CLI รวมไบนารีไว้แล้ว ไม่ต้องคอมไพล์ Rust เอง

หรือจะดาวน์โหลดจาก GitHub, ใช้ Homebrew (brew install googleworkspace/cli) หรือ Nix ก็ได้

การตั้งค่า Google Workspace CLI สำหรับ AI agent

รันคำสั่งนี้เพื่อตั้งค่าและยืนยันตัวตน (สร้างโปรเจกต์, เปิด API, OAuth):

gws auth setup

ระบบจะเปิดเบราว์เซอร์ให้, ตั้งค่าทุกอย่างอัตโนมัติ และบันทึก credential ใน OS keyring (เข้ารหัส)

เพิ่มทักษะ agent

ติดตั้งทักษะ agent ที่เตรียมไว้:

npx skills add https://github.com/googleworkspace/cli

หรือรันตัวติดตั้งเฉพาะ agent (เช่น Claude, Cursor) จากนั้นรีสตาร์ท agent เพื่อให้ตรวจจับ gws อัตโนมัติ

Project-level config

การตั้งค่าทั่วไปเป็น global หากต้องการเฉพาะโปรเจกต์:

gws auth setup --project

การยืนยันตัวตน

ยืนยันหรือเปลี่ยนบัญชี:
```
gws auth login
```
ตรวจสอบผู้ใช้และ scopes:
```
gws auth whoami
```
ออกจากระบบ:
```
gws auth logout
```

สำหรับ headless/CI: export credential

gws auth export --unmasked > creds.json
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/creds.json

ใช้ gcloud token:

export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)

ปิด Telemetry

ปิดการส่งข้อมูล usage แบบไม่ระบุตัวตน:

export GOOGLE_WORKSPACE_CLI_NO_TELEMETRY=1

ตัวอย่างการใช้คำสั่งหลัก (Drive, Gmail, Calendar, Sheets, Docs, Chat)

Google Workspace CLI จะค้นพบคำสั่งแบบไดนามิก

รัน gws --help เพื่อดูบริการทั้งหมด

Drive

แสดงรายการไฟล์:

gws drive files list --params '{"pageSize":10, "q":"name contains report"}'

อัปโหลดไฟล์:

gws drive +upload ./budget.xlsx --name "2026 Budget"

Gmail

ส่งอีเมล:

gws gmail +send --to colleague@example.com --subject "Update" --body "See attached." --attach ./file.pdf

ตอบกลับ/จัดการกล่องจดหมาย:

gws gmail +reply --message-id <ID> --body "Thanks!"
gws gmail +triage

Calendar

สร้าง event:

gws calendar +insert --summary "Sprint Planning" --start "2026-03-20T10:00" --end "2026-03-20T11:00" --attendees "team@example.com"

ดู agenda วันนี้:
```
gws calendar +agenda --today
```

Sheets

เพิ่มแถว:

gws sheets +append --spreadsheetId <ID> --range "Sheet1!A:C" --values "Task X,Done,2026-03-16"

Docs

แทรกข้อความ:

gws docs +write --documentId <ID> --text "New section added via Google Workspace CLI"

Chat

โพสต์ข้อความ:

gws chat +send --space <SPACE_ID> --text "Deployment complete 🚀"

หมายเหตุ:

ใช้ --dry-run กับคำสั่งใดก็ได้ เพื่อดูตัวอย่าง API call โดยไม่ดำเนินการจริง

เพิ่ม --page-all เพื่อดึงข้อมูลแบบ pagination (NDJSON)

การตั้งค่าขั้นสูง

คงค่าด้วย environment variable หรือ .env:

export GOOGLE_WORKSPACE_CLI_DEFAULT_PARAMS='{"prettyPrint":true}'

ปรับ timeout, รูปแบบ output (--json, --yaml), หรือบังคับใช้ keyring แบบไฟล์

ดู option เพิ่มเติม:

gws config

การผสาน Google Workspace CLI กับ AI agent และ prompt

เมื่อเพิ่มทักษะแล้ว agent จะเรียกใช้ gws โดยตรง

ตัวอย่าง prompt:

"List my recent Drive files using Google Workspace CLI"
"Send a follow-up email via Google Workspace CLI"

กฎ agent:

เพิ่มข้อความนี้ในคู่มือ agent (เช่น CLAUDE.md):

"เมื่อใดก็ตามที่งานเกี่ยวข้องกับ Gmail, Drive, Calendar, Sheets, Docs หรือ Chat ให้ใช้คำสั่ง Google Workspace CLI โดยอัตโนมัติก่อนที่จะตอบกลับ ระบุบริการและวิธีการก่อน"

Agent จะคืนค่าไฟล์หรือ JSON ที่สั้นและชัดเจน

ใช้ Apidog เพื่อการทดสอบ API ที่มั่นใจ

Google Workspace CLI ช่วยให้เข้าถึง API ได้ทันที แต่เวลาแก้ไข payload, scopes หรือ response ควรมีเครื่องมือทดสอบ

Apidog เป็น API client ฟรีสำหรับส่งคำขอ, ดู raw response, จัดการ environment ด้วย OAuth token และตรวจสอบอัตโนมัติ

ขั้นตอนการทำงานจริง:

Agent แนะนำให้เพิ่มข้อมูลลง Sheet → ทดสอบ payload ใน Apidog ก่อน
แก้ไขปัญหา Gmail scopes → สร้าง & ทดสอบคำขอใน Apidog
จัดการ service key/token → สลับบัญชีและตรวจสอบ behavior

Google Workspace CLI + Apidog ช่วยให้คุณเข้าถึงข้อมูลแบบสด พร้อมการทดสอบ API ที่ถูกต้องและทวนซ้ำได้

คำถามที่พบบ่อย

Google Workspace CLI ส่งข้อมูลของฉันออกไปภายนอกหรือไม่?

ไม่ ข้อมูลจะถูกส่งตรงไปยัง Google APIs เท่านั้น

รองรับบริการอะไรบ้าง?

Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, Script และอื่นๆ ที่ค้นพบแบบไดนามิก

คำสั่งอัปเดตทันทีหรือไม่?

ใช่ CLI ใช้ Discovery Service สด วิธีใหม่ๆ จะโผล่ทันที

ต้องใช้ API key หรือเปล่า?

ไม่ ใช้ Google OAuth ทั่วไปหรือ service account

รองรับ agent/editor ไหนบ้าง?

Claude Code, Cursor, OpenClaw, Gemini CLI, VS Code extension, หรือเครื่องมือที่ใช้ MCP/Agent Skills

ความต่างระหว่างคำสั่งดิบกับ +helper?

ดิบ = เรียก method API ตรง เช่น drive.files.list

+helper = shortcut งานทั่วไป เช่น +upload, +send

ใช้ Google Workspace CLI โดยไม่มี AI agent ได้ไหม?

ได้ เหมาะกับสคริปต์หรืองานเทอร์มินัลทั่วไป

แหล่งข้อมูลเพิ่มเติม

พื้นที่เก็บข้อมูล GitHub ของ Google Workspace CLI → https://github.com/googleworkspace/cli
README และเอกสารฉบับเต็ม → https://github.com/googleworkspace/cli/blob/main/README.md
โฟลเดอร์ทักษะของ Agent → https://github.com/googleworkspace/cli/tree/main/skills
การอ้างอิง Google Workspace API → https://developers.google.com/workspace
แดชบอร์ดโควตา → https://console.cloud.google.com/apis/api
ไคลเอนต์ API ฟรี Apidog → https://apidog.com?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation

DEV Community