Google Workspace CLI (dipanggil sebagai gws) adalah alat baris perintah dinamis sumber terbuka yang memberikan akses terpadu kepada manusia dan agen AI ke Drive, Gmail, Kalender, Sheets, Docs, Chat, Admin, dan setiap Google Workspace API—dibangun langsung dari Google Discovery Service secara langsung sehingga perintah tetap mutakhir tanpa pembaruan. Instal Google Workspace CLI secara global melalui npm, otentikasi sekali dengan OAuth, dan sambungkan ke agen seperti Claude Code atau Cursor dengan skill yang disertakan. Tidak diperlukan alur OAuth boilerplate atau SDK terpisah.
Apa itu Google Workspace CLI dan mengapa penting?Ini adalah masalah yang dihadapi setiap pengembang, admin, dan pengguna agen AI: Anda ingin mengotomatisasi atau membuat kueri layanan Google Workspace (file Drive, mengirim Gmail, membuat acara Kalender, menambahkan ke Sheets, mengedit Docs, memposting di Chat), tetapi Anda akhirnya menulis skrip curl kustom, bergulat dengan cakupan OAuth, menangani paginasi secara manual, atau menyatukan beberapa SDK yang sudah usang.
Ini terjadi karena Google Workspace API sangat kuat tetapi terfragmentasi; setiap layanan memiliki titik akhir, alur otentikasi, dan keanehan tersendiri. Alat tradisional memaksa Anda untuk mempertahankan kode boilerplate yang rusak karena perubahan API.
Google Workspace CLI memecahkan masalah ini. Dirilis pada awal tahun 2026 oleh tim Google (diumumkan oleh Addy Osmani), ini adalah CLI tunggal bertenaga Rust yang secara dinamis menemukan setiap metode API Workspace saat runtime menggunakan Google Discovery Service. Anda mendapatkan akses instan ke titik akhir baru tanpa menunggu pembaruan alat.
Hasilnya: skrip, agen, dan pekerjaan terminal harian Anda tetap akurat dan mutakhir. Google Workspace CLI menghasilkan JSON yang bersih, mendukung dry-run, pembantu paginasi, dan menyertakan 40+ pintasan yang mudah digunakan manusia (diawali dengan +) seperti gws gmail +send atau gws calendar +agenda.
Google Workspace CLI juga dilengkapi dengan skill agen yang siap diinstal, sehingga alat seperti Claude Code, Cursor, OpenClaw, atau Gemini CLI dapat secara otonom mengelola Workspace Anda—tidak diperlukan definisi alat kustom.
Jika Anda membangun atau menguji integrasi API bersama dengan otomatisasi Workspace, Apidog menangani sisi verifikasi. Ini adalah klien API gratis untuk mengirim permintaan, memeriksa respons, mengelola lingkungan, dan menjalankan rangkaian pengujian. Bersama-sama, Google Workspace CLI memberikan akses langsung ke data Anda, dan Apidog mengonfirmasi bahwa setiap panggilan berfungsi seperti yang diharapkan.
Menginstal Google Workspace CLISatu-satunya persyaratan adalah Node.js 18 atau yang lebih baru. Periksa versi Anda dengan:
node --versionJalankan tanpa menginstalCara tercepat untuk mencoba Google Workspace CLI adalah dengan npx (menarik versi terbaru setiap kali):
npx @googleworkspace/cli --help
npx @googleworkspace/cli drive files list --params '{"pageSize":1}'Baik untuk tes cepat atau skrip sekali pakai.
Instal secara globalUntuk penggunaan rutin, instal secara global agar perintah gws selalu tersedia:
npm install -g @googleworkspace/cli
gws --versionGoogle Workspace CLI mengemas biner yang sudah dibuat sebelumnya, jadi waktu startup cepat—tidak perlu mengompilasi Rust secara lokal. Anda juga dapat mengambil biner dari Rilis GitHub, menggunakan Homebrew (brew install googleworkspace/cli), atau menjalankannya melalui Nix jika diinginkan.
Menyiapkan Google Workspace CLI untuk agen pengkodean AI AndaPerintah gws auth setup menangani pembuatan proyek, pengaktifan API, dan OAuth awal dalam satu alur terpandu. Jalankan:
gws auth setupIni membuka browser Anda, membuat proyek Google Cloud jika diperlukan, mengaktifkan API yang diperlukan, dan menyimpan kredensial dengan aman di keyring OS Anda (dienkripsi AES-256-GCM).
Targetkan agen tertentu atau instal skillSetelah pengaturan, instal skill agen yang dibundel:
npx skills add https://github.com/googleworkspace/cliAtau jalankan penginstal khusus agen (misalnya, untuk Claude Code atau Cursor). Mulai ulang agen Anda agar secara otomatis menemukan perintah Google Workspace CLI.
Pengaturan tingkat proyek vs. globalSecara default, pengaturan berlaku secara global. Untuk konfigurasi khusus proyek:
gws auth setup --projectOtentikasiOtentikasi ulang atau ganti akun kapan saja:
gws auth loginPeriksa pengguna dan cakupan saat ini:
gws auth whoamiKeluar saat dibutuhkan:
gws auth logoutUntuk penggunaan headless/CI, ekspor kredensial:
gws auth export --unmasked > creds.json
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/creds.jsonAtau gunakan kembali token gcloud: export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token).
TelemetriNonaktifkan pengumpulan penggunaan anonim:
export GOOGLE_WORKSPACE_CLI_NO_TELEMETRY=1Menggunakan perintah inti di Google Workspace CLI (Drive, Gmail, Calendar, Sheets, Docs, Chat)Google Workspace CLI menemukan perintah secara dinamis—tidak ada daftar tetap. Jalankan gws --help untuk melihat layanan yang tersedia.
File dan folder DriveDaftar file terbaru:
gws drive files list --params '{"pageSize":10, "q":"name contains report"}'Unggah dengan pembantu:
gws drive +upload ./budget.xlsx --name "Anggaran 2026"GmailKirim email:
gws gmail +send --to rekan@contoh.com --subject "Pembaruan" --body "Lihat lampiran." --attach ./file.pdfBalas atau sortir kotak masuk:
gws gmail +reply --message-id <ID> --body "Terima kasih!"
gws gmail +triageKalenderBuat acara:
gws calendar +insert --summary "Perencanaan Sprint" --start "2026-03-20T10:00" --end "2026-03-20T11:00" --attendees "tim@contoh.com"Tampilkan agenda hari ini:
gws calendar +agenda --todaySheetsTambahkan baris:
gws sheets +append --spreadsheetId <ID> --range "Sheet1!A:C" --values "Tugas X,Selesai,2026-03-16"DocsSisipkan teks:
gws docs +write --documentId <ID> --text "Bagian baru ditambahkan melalui Google Workspace CLI"ChatKirim pesan:
gws chat +send --space <SPACE_ID> --text "Penyebaran selesai 🚀"Gunakan --dry-run pada perintah apa pun untuk melihat pratinjau panggilan API yang tepat tanpa mengeksekusi. Tambahkan --page-all untuk paginasi lengkap sebagai NDJSON.
Konfigurasi lanjutan dan opsi global di Google Workspace CLIPertahankan pengaturan dengan variabel lingkungan atau file .env:
export GOOGLE_WORKSPACE_CLI_DEFAULT_PARAMS='{"prettyPrint":true}'Sesuaikan waktu tunggu, format keluaran (--json, --yaml), atau paksa keyring berbasis file. Lihat konfigurasi:
gws configMengintegrasikan Google Workspace CLI dengan agen AI dan promptSetelah skill diinstal, agen memanggil Google Workspace CLI secara native.
Pola "gunakan gws"Dalam prompt: "Daftar file Drive terbaru saya menggunakan Google Workspace CLI" atau "Kirim email tindak lanjut melalui Google Workspace CLI".
Aturan pemicu otomatisTambahkan ke instruksi agen Anda (misalnya, CLAUDE.md atau aturan Cursor):
"Setiap kali tugas melibatkan Gmail, Drive, Kalender, Sheets, Docs, atau Chat, gunakan perintah Google Workspace CLI secara otomatis sebelum merespons. Selesaikan layanan dan metode terlebih dahulu."
Agen mengembalikan jalur file atau hasil JSON, menjaga konteks tetap ramping.
Pasangkan dengan Apidog untuk kepercayaan API yang lengkapGoogle Workspace CLI membuat Google Workspace API dapat diakses secara instan, tetapi saat men-debug payload, cakupan, atau respons, Anda memerlukan visibilitas.
Apidog adalah klien API gratis yang memungkinkan Anda mengirim permintaan, memeriksa respons mentah, menyiapkan lingkungan dengan token OAuth, dan mengotomatiskan pernyataan.
Alur kerja nyata:
- Agen menyarankan untuk menambahkan ke Sheet → Uji payload Sheets.values.append yang tepat di Apidog terlebih dahulu.
- Pecahkan masalah cakupan pengiriman Gmail → Bangun dan jalankan permintaan secara visual.
- Simpan kunci akun layanan atau token pengguna sebagai variabel → Ganti akun dan validasi perilaku.
Google Workspace CLI + Apidog memberikan akses data langsung ditambah pengujian API yang terverifikasi dan dapat diulang.
FAQApakah Google Workspace CLI mengirimkan data saya secara eksternal?Tidak ada panggilan yang langsung ke Google API. Konten Anda tidak pernah meninggalkan akun Google Anda.
Layanan apa saja yang didukung Google Workspace CLI?Setiap Google Workspace API ditemukan secara dinamis: Drive, Gmail, Kalender, Sheets, Docs, Chat, Admin, Script, dan lainnya.
Seberapa mutakhir perintahnya?Google Workspace CLI mengkueri Discovery Service secara langsung—metode baru muncul secara otomatis.
Apakah memerlukan kunci API?Menggunakan OAuth Google standar atau akun layanan—tidak ada kunci terpisah selain kredensial otentikasi.
Agen dan editor apa saja yang didukung Google Workspace CLI?Claude Code, Cursor, OpenClaw, Gemini CLI, ekstensi VS Code—alat yang kompatibel dengan MCP atau Agent Skills.
Apa perbedaan antara perintah mentah dan pembantu +?Mentah = metode Discovery yang tepat (misalnya, drive.files.list). + pembantu = pintasan untuk tugas umum (misalnya, +upload, +send).
Dapatkah saya menggunakan Google Workspace CLI tanpa agen AI?Ya, sempurna untuk skrip, otomatisasi, atau penggunaan terminal harian.
Sumber daya tambahan
- Repositori GitHub Google Workspace CLI → https://github.com/googleworkspace/cli
- README & dokumen lengkap → https://github.com/googleworkspace/cli/blob/main/README.md
- Folder skill agen → https://github.com/googleworkspace/cli/tree/main/skills
- Referensi Google Workspace API → https://developers.google.com/workspace
- Dasbor Kuota → https://console.cloud.google.com/apis/api
- Klien API gratis Apidog → https://apidog.com