DEV Community

Cover image for Cara Menggunakan Google Workspace CLI: Panduan Lengkap
Walse
Walse

Posted on • Originally published at apidog.com

Cara Menggunakan Google Workspace CLI: Panduan Lengkap

#automation #cli #google #tutorial

Google Workspace CLI (gws) adalah alat command line open source yang memberikan akses instan ke Drive, Gmail, Kalender, Sheets, Docs, Chat, Admin, dan semua Google Workspace API. CLI ini secara dinamis membangun perintah dari Google Discovery Service, sehingga Anda selalu menggunakan API terbaru tanpa perlu update manual. Install secara global via npm, lakukan autentikasi sekali dengan OAuth, dan integrasikan dengan agen seperti Claude Code atau Cursor menggunakan skill yang sudah dibundel. Tidak perlu boilerplate OAuth flow atau SDK terpisah.

Coba Apidog hari ini

Masalah Umum Otomasi Workspace

Setiap developer, admin, atau pengguna AI agent pasti pernah mengalami kesulitan mengotomasi Google Workspace: ingin mengakses file Drive, mengirim Gmail, membuat event Kalender, menambah data ke Sheets, mengedit Docs, atau posting di Chat, tetapi harus menulis skrip curl manual, mengelola OAuth scopes, paginasi, atau menggabungkan SDK yang kadaluarsa.

Hal ini terjadi karena API Google Workspace sangat kuat tapi terfragmentasi—setiap layanan punya endpoint, autentikasi, dan keunikan sendiri. Kode boilerplate sering rusak saat API berubah.

Google Workspace CLI menyederhanakan ini. Dirilis awal 2026 oleh tim Google (diumumkan Addy Osmani), CLI berbasis Rust ini secara dinamis memetakan semua metode API Workspace saat runtime via Discovery Service Google. Anda langsung dapat endpoint baru tanpa menunggu update alat.

CLI ini menghasilkan output JSON yang bersih, mendukung dry-run, helper paginasi, dan punya 40+ shortcut (awalan +) seperti gws gmail +send atau gws calendar +agenda.

Google Workspace CLI juga menyertakan skill agent siap pakai, sehingga Claude Code, Cursor, OpenClaw, atau Gemini CLI dapat mengelola Workspace secara otomatis—tanpa definisi alat custom.

Jika Anda membangun atau menguji integrasi API dan otomatisasi Workspace, Apidog adalah klien API gratis untuk mengirim request, memeriksa response, mengelola environment, dan menjalankan test suite. Kombinasi gws + Apidog memastikan setiap call berfungsi seperti yang diharapkan.

Instalasi Google Workspace CLI

Prasyarat: Node.js 18 ke atas. Cek versi:

node --version
Enter fullscreen mode Exit fullscreen mode

Jalankan Tanpa Instalasi

Untuk mencoba cepat, gunakan npx (selalu versi terbaru):

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

Cocok untuk tes atau skrip sekali jalan.

Instalasi Global

Untuk penggunaan rutin, install global:

npm install -g @googleworkspace/cli
gws --version
Enter fullscreen mode Exit fullscreen mode

Google Workspace CLI membawa binary siap pakai, jadi startup cepat—tidak perlu compile Rust lokal. Alternatif: download binary dari GitHub Releases, install via Homebrew (brew install googleworkspace/cli), atau jalankan via Nix.

Konfigurasi dan Otentikasi

Setup Otomatis

Jalankan satu perintah untuk setup proyek, enable API, dan OAuth:

gws auth setup
Enter fullscreen mode Exit fullscreen mode

Browser akan terbuka, proyek Google Cloud dibuat jika perlu, enable API, simpan kredensial di keyring OS (terenkripsi AES-256-GCM).

Instalasi Skill Agent

Pasang skill agent bawaan:

npx skills add https://github.com/googleworkspace/cli
Enter fullscreen mode Exit fullscreen mode

Atau jalankan installer khusus agent (ex: Claude Code, Cursor). Restart agent agar perintah gws otomatis dikenali.

Konfigurasi Project-level

Secara default, setup berlaku global. Untuk konfigurasi per-proyek:

gws auth setup --project
Enter fullscreen mode Exit fullscreen mode

Otentikasi Ulang & Manajemen Akun

  • Login ulang/ganti akun: 
  gws auth login
Enter fullscreen mode Exit fullscreen mode
  • Cek user & scopes: 
  gws auth whoami
Enter fullscreen mode Exit fullscreen mode
  • Logout: 
  gws auth logout
Enter fullscreen mode Exit fullscreen mode
  • Export credential untuk headless/CI: 
  gws auth export --unmasked > creds.json
  export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/creds.json
Enter fullscreen mode Exit fullscreen mode
  • Gunakan token gcloud: 
  export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)
Enter fullscreen mode Exit fullscreen mode

Nonaktifkan Telemetri 

export GOOGLE_WORKSPACE_CLI_NO_TELEMETRY=1
Enter fullscreen mode Exit fullscreen mode

Contoh Perintah Google Workspace CLI

Google Workspace CLI membangun perintah secara dinamis. Lihat semua layanan:

gws --help
Enter fullscreen mode Exit fullscreen mode

Drive

  • Daftar file terbaru: 
  gws drive files list --params '{"pageSize":10, "q":"name contains report"}'
Enter fullscreen mode Exit fullscreen mode
  • Upload file: 
  gws drive +upload ./budget.xlsx --name "Anggaran 2026"
Enter fullscreen mode Exit fullscreen mode

Gmail

  • Kirim email: 
  gws gmail +send --to rekan@contoh.com --subject "Pembaruan" --body "Lihat lampiran." --attach ./file.pdf
Enter fullscreen mode Exit fullscreen mode
  • Balas/sortir inbox: 
  gws gmail +reply --message-id <ID> --body "Terima kasih!"
  gws gmail +triage
Enter fullscreen mode Exit fullscreen mode

Calendar

  • Buat acara: 
  gws calendar +insert --summary "Perencanaan Sprint" --start "2026-03-20T10:00" --end "2026-03-20T11:00" --attendees "tim@contoh.com"
Enter fullscreen mode Exit fullscreen mode
  • Tampilkan agenda hari ini: 
  gws calendar +agenda --today
Enter fullscreen mode Exit fullscreen mode

Sheets

  • Tambah baris: 
  gws sheets +append --spreadsheetId <ID> --range "Sheet1!A:C" --values "Tugas X,Selesai,2026-03-16"
Enter fullscreen mode Exit fullscreen mode

Docs

  • Sisipkan teks ke dokumen: 
  gws docs +write --documentId <ID> --text "Bagian baru ditambahkan melalui Google Workspace CLI"
Enter fullscreen mode Exit fullscreen mode

Chat

  • Kirim pesan: 
  gws chat +send --space <SPACE_ID> --text "Penyebaran selesai 🚀"
Enter fullscreen mode Exit fullscreen mode

Tips:

Gunakan --dry-run untuk pratinjau API call tanpa mengeksekusi. Tambahkan --page-all untuk paginasi penuh (NDJSON).

Konfigurasi Lanjutan & Opsi Global

  • Simpan setting dengan env var/.env: 
  export GOOGLE_WORKSPACE_CLI_DEFAULT_PARAMS='{"prettyPrint":true}'
Enter fullscreen mode Exit fullscreen mode
  • Atur timeout, format output (--json, --yaml), atau gunakan keyring file.
  • Lihat konfigurasi: 
  gws config
Enter fullscreen mode Exit fullscreen mode

Integrasi dengan Agen AI & Prompt

Setelah skill diinstal, agen bisa memanggil perintah gws secara native.

Pola "gunakan gws" di prompt

Contoh prompt:

  • "Daftar file Drive terbaru saya menggunakan Google Workspace CLI"
  • "Kirim email tindak lanjut via Google Workspace CLI"

Aturan Pemicu Otomatis

Masukkan ke instruksi agent (misal di CLAUDE.md):

"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 akan mengembalikan file path atau hasil JSON, menjaga konteks tetap efisien.

Integrasi dengan Apidog untuk Uji API

Google Workspace CLI membuat Workspace API langsung digunakan. Untuk debug payload, scope, atau response, Apidog memberi visibilitas lebih:

  • Kirim permintaan Sheets.values.append sebelum otomatisasi → pastikan payload benar.
  • Debug scope Gmail → buat & jalankan permintaan visual.
  • Simpan service key/user token sebagai variabel → uji switching akun dan validasi.

Dengan Google Workspace CLI + Apidog, Anda mendapatkan akses data langsung dan pengujian API yang dapat diulang.

FAQ

Apakah Google Workspace CLI mengirim data eksternal?

Tidak. Semua panggilan langsung ke Google API. Data Anda tetap di akun Google.

Layanan apa saja yang didukung?

Semua Google Workspace API: Drive, Gmail, Kalender, Sheets, Docs, Chat, Admin, Script, dst (dinamis via Discovery Service).

Seberapa mutakhir perintahnya?

Selalu update. CLI mengkueri Discovery Service langsung, metode baru otomatis muncul.

Apakah perlu API key?

Menggunakan OAuth Google/Service Account standar. Tidak ada kunci terpisah selain kredensial otentikasi.

Agent/editor apa yang didukung?

Claude Code, Cursor, OpenClaw, Gemini CLI, ekstensi VS Code—semua alat kompatibel MCP/Agent Skills.

Bedanya perintah mentah vs. + helper?

Mentah = method Discovery langsung (ex: drive.files.list). Helper "+" = shortcut tugas umum (ex: +upload, +send).

Bisa pakai tanpa AI agent?

Bisa, cocok untuk skrip, otomatisasi, atau terminal harian.

Sumber Daya Tambahan

Top comments (0)