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

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

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

Google Workspace CLI คืออะไรและทำไมถึงสำคัญ?นี่คือปัญหาที่นักพัฒนา ผู้ดูแลระบบ และผู้ใช้ AI agent ทุกคนเคยเจอ: คุณต้องการทำให้บริการของ Google Workspace เป็นอัตโนมัติหรือสอบถามข้อมูล (ไฟล์ Drive, ส่ง Gmail, สร้างกิจกรรมใน Calendar, เพิ่มข้อมูลใน Sheets, แก้ไข Docs, โพสต์ใน Chat) แต่สุดท้ายคุณต้องเขียนสคริปต์ curl แบบกำหนดเอง, จัดการกับ OAuth scopes, จัดการการแบ่งหน้าด้วยตนเอง หรือรวม SDK หลายตัวที่ล้าสมัย

สิ่งนี้เกิดขึ้นเพราะ API ของ Google Workspace นั้นทรงพลังแต่ก็แยกส่วนกัน แต่ละบริการมีปลายทาง การยืนยันตัวตน และคุณสมบัติเฉพาะของตัวเอง เครื่องมือแบบดั้งเดิมบังคับให้คุณต้องดูแลโค้ดสำเร็จรูปที่เสียเมื่อมีการเปลี่ยนแปลง API

Google Workspace CLI ช่วยแก้ปัญหานี้ เปิดตัวในต้นปี 2026 โดยทีมงาน Google (ประกาศโดย Addy Osmani) เป็น CLI เดี่ยวที่ขับเคลื่อนด้วย Rust ซึ่งค้นพบวิธีการของ Workspace API ทุกอย่างแบบไดนามิกขณะรันไทม์โดยใช้ Google's Discovery Service คุณสามารถเข้าถึงปลายทางใหม่ได้ทันทีโดยไม่ต้องรอการอัปเดตเครื่องมือ

ผลลัพธ์คือ: สคริปต์, agent และการทำงานในเทอร์มินัลประจำวันของคุณจะถูกต้องและเป็นปัจจุบันอยู่เสมอ Google Workspace CLI แสดงผล JSON ที่สะอาด, รองรับการทดลองรัน (dry-runs), ตัวช่วยในการแบ่งหน้า (pagination helpers) และมีทางลัดที่ใช้งานง่ายกว่า 40+ รายการ (ขึ้นต้นด้วย +) เช่น gws gmail +send หรือ gws calendar +agenda

Google Workspace CLI ยังมาพร้อมกับทักษะของ agent ที่พร้อมติดตั้ง ทำให้เครื่องมืออย่าง Claude Code, Cursor, OpenClaw หรือ Gemini CLI สามารถจัดการ Workspace ของคุณได้ด้วยตนเอง—ไม่จำเป็นต้องกำหนดเครื่องมือแบบกำหนดเอง

หากคุณกำลังสร้างหรือทดสอบการผสานรวม API ควบคู่ไปกับการทำงานอัตโนมัติของ Workspace, Apidog จะจัดการด้านการตรวจสอบ เป็นไคลเอนต์ API ฟรีสำหรับการส่งคำขอ, ตรวจสอบการตอบสนอง, จัดการสภาพแวดล้อม และรันชุดทดสอบ เมื่อใช้ร่วมกัน, Google Workspace CLI ให้การเข้าถึงข้อมูลของคุณแบบสด และ Apidog ยืนยันว่าการเรียกใช้ทุกครั้งทำงานได้ตามที่คาดไว้

การติดตั้ง Google Workspace CLIข้อกำหนดเดียวคือ Node.js 18 หรือใหม่กว่า ตรวจสอบเวอร์ชันของคุณด้วย:

node --version

รันโดยไม่ต้องติดตั้งวิธีที่เร็วที่สุดในการลองใช้ Google Workspace CLI คือใช้ npx (ดึงเวอร์ชันล่าสุดทุกครั้ง):

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

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

ติดตั้งทั่วโลกสำหรับการใช้งานปกติ ให้ติดตั้งทั่วโลกเพื่อให้คำสั่ง gws พร้อมใช้งานเสมอ:

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

Google Workspace CLI รวมไบนารีที่สร้างไว้ล่วงหน้า ดังนั้นการเริ่มต้นจึงรวดเร็ว ไม่จำเป็นต้องคอมไพล์ Rust ในเครื่อง คุณยังสามารถดาวน์โหลดไบนารีจาก GitHub Releases, ใช้ Homebrew (brew install googleworkspace/cli) หรือรันผ่าน Nix หากต้องการ

การตั้งค่า Google Workspace CLI สำหรับ AI coding agent ของคุณคำสั่ง gws auth setup จะจัดการการสร้างโปรเจกต์, การเปิดใช้งาน API และ OAuth เริ่มต้นในโฟลว์แนะนำเดียว รัน:

gws auth setup

มันจะเปิดเบราว์เซอร์ของคุณ, สร้างโปรเจกต์ Google Cloud หากจำเป็น, เปิดใช้งาน API ที่จำเป็น และบันทึกข้อมูลรับรองอย่างปลอดภัยใน OS keyring ของคุณ (เข้ารหัส AES-256-GCM)

กำหนดเป้าหมาย agent เฉพาะหรือติดตั้งทักษะหลังจากตั้งค่าแล้ว ให้ติดตั้งทักษะ agent ที่มาพร้อมกับชุดซอฟต์แวร์:

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

หรือรันโปรแกรมติดตั้งเฉพาะ agent (เช่น สำหรับ Claude Code หรือ Cursor) รีสตาร์ท agent ของคุณเพื่อให้มันค้นพบคำสั่ง Google Workspace CLI โดยอัตโนมัติ

การตั้งค่าระดับโปรเจกต์เทียบกับการตั้งค่าทั่วโลกโดยค่าเริ่มต้น การตั้งค่าจะใช้ได้ทั่วโลก สำหรับการกำหนดค่าเฉพาะโปรเจกต์:

gws auth setup --project

การยืนยันตัวตนยืนยันตัวตนใหม่หรือเปลี่ยนบัญชีได้ตลอดเวลา:

gws auth login

ตรวจสอบผู้ใช้ปัจจุบันและ scopes:

gws auth whoami

ออกจากระบบเมื่อจำเป็น:

gws auth logout

สำหรับการใช้งานแบบ Headless/CI ให้ส่งออกข้อมูลรับรอง:

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

หรือใช้โทเค็น gcloud ซ้ำ: export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)

การรวบรวมข้อมูลการใช้งาน (Telemetry)ปิดใช้งานการรวบรวมข้อมูลการใช้งานที่ไม่ระบุตัวตน:

export GOOGLE_WORKSPACE_CLI_NO_TELEMETRY=1

การใช้คำสั่งหลักใน Google Workspace CLI (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สร้างกิจกรรม:

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

แสดงวาระการประชุมวันนี้:

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 ที่แน่นอนโดยไม่ต้องดำเนินการ เพิ่ม --page-all เพื่อการแบ่งหน้าแบบเต็มในรูปแบบ NDJSON

การกำหนดค่าขั้นสูงและตัวเลือกทั่วโลกใน Google Workspace CLIคงการตั้งค่าด้วยตัวแปรสภาพแวดล้อมหรือไฟล์ .env:

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

ปรับการหมดเวลา, รูปแบบเอาต์พุต (--json, --yaml) หรือบังคับใช้ keyring แบบไฟล์ ดูการกำหนดค่า:

gws config

การผสานรวม Google Workspace CLI กับ AI agent และพรอมต์เมื่อติดตั้งทักษะแล้ว agent จะเรียกใช้ Google Workspace CLI แบบดั้งเดิม

รูปแบบ "use gws"ในพรอมต์: "List my recent Drive files using Google Workspace CLI" หรือ "Send a follow-up email via Google Workspace CLI"

กฎการเรียกใช้โดยอัตโนมัติเพิ่มลงในคำแนะนำของ agent ของคุณ (เช่น CLAUDE.md หรือกฎ Cursor):

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

Agent จะส่งคืนเส้นทางไฟล์หรือผลลัพธ์ JSON ทำให้บริบทกระชับ

จับคู่กับ Apidog เพื่อความมั่นใจใน API อย่างสมบูรณ์Google Workspace CLI ทำให้ API ของ Workspace เข้าถึงได้ทันที แต่เมื่อแก้ไขข้อผิดพลาดในเพย์โหลด, สโคป หรือการตอบกลับ คุณจำเป็นต้องมีวิสัยทัศน์ที่ชัดเจน

Apidog เป็นไคลเอนต์ API ฟรีที่ช่วยให้คุณสามารถส่งคำขอ, ตรวจสอบการตอบกลับดิบ, ตั้งค่าสภาพแวดล้อมด้วยโทเค็น OAuth และตรวจสอบยืนยันอัตโนมัติ

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

• Agent แนะนำให้เพิ่มข้อมูลลงใน Sheet → ทดสอบเพย์โหลด Sheets.values.append ที่แน่นอนใน Apidog ก่อน
• แก้ไขปัญหาสโคปการส่ง Gmail → สร้างและรันคำขอด้วยภาพ
• จัดเก็บคีย์บัญชีบริการหรือโทเค็นผู้ใช้เป็นตัวแปร → สลับบัญชีและตรวจสอบพฤติกรรม

Google Workspace CLI + Apidog มอบการเข้าถึงข้อมูลแบบสดพร้อมการทดสอบ API ที่ผ่านการตรวจสอบและทำซ้ำได้

คำถามที่พบบ่อยGoogle Workspace CLI ส่งข้อมูลของฉันออกไปภายนอกหรือไม่?ไม่ มีการเรียกใช้โดยตรงไปยัง Google APIs เนื้อหาของคุณจะไม่ออกจากบัญชี Google ของคุณ

Google Workspace CLI รองรับบริการใดบ้าง?ทุก Workspace API ที่ค้นพบแบบไดนามิก: Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, Script และอื่นๆ

คำสั่งมีความเป็นปัจจุบันแค่ไหน?Google Workspace CLI สอบถาม Discovery Service แบบสด วิธีการใหม่จะปรากฏขึ้นโดยอัตโนมัติ

ต้องใช้คีย์ API หรือไม่?ใช้ Google OAuth มาตรฐานหรือบัญชีบริการ—ไม่มีคีย์แยกต่างหากนอกเหนือจากข้อมูลรับรองการยืนยันตัวตน

Google Workspace CLI รองรับ agent และ editor ใดบ้าง?Claude Code, Cursor, OpenClaw, Gemini CLI, ส่วนขยาย VS Code—เครื่องมือที่เข้ากันได้กับ MCP หรือ Agent Skills ใดๆ

ความแตกต่างระหว่างคำสั่งดิบและ + helpers คืออะไร?ดิบ = วิธีการ Discovery ที่แน่นอน (เช่น drive.files.list) + helpers = ทางลัดสำหรับงานทั่วไป (เช่น +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