DEV Community

Cover image for Google Workspace CLI Nasıl Kullanılır?
Tobias Hoffmann
Tobias Hoffmann

Posted on • Originally published at apidog.com

Google Workspace CLI Nasıl Kullanılır?

#api #cli #google #tutorial

Google Workspace CLI (gws olarak çağrılır), açık kaynaklı ve dinamik bir komut satırı aracıdır. Bu araç sayesinde hem insanlar hem de yapay zeka ajanları; Drive, Gmail, Takvim, E-Tablolar, Dokümanlar, Chat, Yönetici ve tüm Google Workspace API’lerine tek noktadan erişim sağlayabilir. Komutlar doğrudan Google’ın canlı Discovery Service’inden türetilir, yani güncel kalmak için herhangi bir güncelleme beklemenize gerek yok. Npm ile kolayca kurulum yapabilir, OAuth ile hızlıca kimlik doğrulaması gerçekleştirebilir ve Claude Code veya Cursor gibi ajanlara doğrudan bağlanabilirsiniz. Ekstra OAuth döngüleri veya fazladan SDK yönetimiyle uğraşmanıza gerek kalmaz.

Apidog'u bugün deneyin

Neden Google Workspace CLI Kullanmalısınız?

Drive dosyalarını sorgulamak, Gmail göndermek, Takvim etkinliği oluşturmak veya E-Tablolara veri eklemek gibi işlemleri otomatikleştirmek çoğu zaman karmaşık OAuth kapsamları, özel curl komutları ve manuel sayfalandırma ile uğraşmayı gerektirir. Her servisin ayrı uç noktaları ve kimlik doğrulama akışları olması, klasik yöntemlerle tekrarlayan ve bakımı zor kodlara sebep olur.

Google Workspace CLI bu zorlukları ortadan kaldırır. 2026 başında duyurulan bu araç, çalışma zamanında tüm Workspace API’lerini otomatik keşfeder ve Rust tabanlı hızlı bir CLI deneyimi sunar. Yeni API uç noktalarına anında erişebilirsiniz; güncellemeleri beklemenize gerek yoktur.

Komutlar temiz JSON çıktısı sunar, dry-run (kuru çalıştırma) ile API çağrılarını önizleyebilir, sayfalandırma yardımcılarını ve 40’tan fazla + ile başlayan kısa yolu kullanabilirsiniz (ör. gws gmail +send, gws calendar +agenda). Ayrıca, Claude Code, Cursor, OpenClaw veya Gemini CLI gibi popüler kodlama ajanları ile herhangi bir ekstra entegrasyon olmadan çalışır.

Google Workspace otomasyonu ve API entegrasyonu ile çalışıyorsanız, Apidog ile API çağrılarınızın doğruluğunu kolayca test edebilirsiniz. Apidog, istek oluşturma, yanıt inceleme, ortam yönetimi ve test paketleri çalıştırmak için kullanabileceğiniz ücretsiz bir API istemcisidir. Workspace CLI ile canlı veri erişimi sağlarken, Apidog ile çağrılarınızın doğruluğunu garanti edersiniz.

Google Workspace CLI Kurulumu

Gereksinimler:

Node.js 18 veya üstü. Sürümünüzü kontrol edin:

node --version
Enter fullscreen mode Exit fullscreen mode

Hızlı Başlangıç: NPX ile Çalıştırma

Kurulum yapmadan, en güncel sürümü hızlıca test etmek için:

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

Bu yöntem hızlı testler veya tek seferlik komutlar için idealdir.

Kalıcı Kullanım: Global Kurulum

Düzenli kullanım için CLI’yı global yükleyin:

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

CLI önceden derlenmiş ikili dosyalar içerir; Rust derlemesiyle uğraşmanıza gerek yoktur. Alternatif olarak, GitHub Releases, Homebrew (brew install googleworkspace/cli) veya Nix ile de kurabilirsiniz.

Yapay Zeka Kodlama Aracıyla Entegrasyon

CLI’yı bir ajana (ör. Claude Code veya Cursor) entegre etmek için:

gws auth setup
Enter fullscreen mode Exit fullscreen mode

Bu komut, tarayıcıda proje oluşturur, gerekli API’leri etkinleştirir ve OAuth kimlik bilgilerini işletim sisteminizin anahtarlığına AES-256-GCM ile kaydeder.

Ajan becerilerini yüklemek için:

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

Ajan özel yükleyici gerekiyorsa (ör. Claude Code, Cursor), ilgili yönergeleri izleyin ve ajanınızı yeniden başlatın.

Proje seviyesinde kurulum için:

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

Kimlik Doğrulama Yönetimi

Her zaman yeniden kimlik doğrulaması yapabilir, hesap değiştirebilir veya oturumu sonlandırabilirsiniz:

gws auth login
gws auth whoami
gws auth logout
Enter fullscreen mode Exit fullscreen mode

Başsız kullanım veya CI/CD için kimlik bilgilerini dışa aktarın:

gws auth export --unmasked > creds.json
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/creds.json
Enter fullscreen mode Exit fullscreen mode

Veya gcloud token’ınızı kullanın:

export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)
Enter fullscreen mode Exit fullscreen mode

Telemetriyi kapatmak için:

export GOOGLE_WORKSPACE_CLI_NO_TELEMETRY=1
Enter fullscreen mode Exit fullscreen mode

Temel Komutlar: Drive, Gmail, Takvim, E-Tablolar, Dokümanlar, Chat

Komutlar dinamik olarak keşfedilir; mevcut hizmetleri görmek için:

gws --help
Enter fullscreen mode Exit fullscreen mode

Drive

Son dosyaları listeleyin:

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

Dosya yükleyin:

gws drive +upload ./budget.xlsx --name "2026 Bütçesi"
Enter fullscreen mode Exit fullscreen mode

Gmail

E-posta gönderin:

gws gmail +send --to colleague@example.com --subject "Güncelleme" --body "Ekte görebilirsiniz." --attach ./file.pdf
Enter fullscreen mode Exit fullscreen mode

Yanıtlayın veya gelen kutusunu yönetin:

gws gmail +reply --message-id <ID> --body "Teşekkürler!"
gws gmail +triage
Enter fullscreen mode Exit fullscreen mode

Takvim

Etkinlik oluşturun:

gws calendar +insert --summary "Sprint Planlaması" --start "2026-03-20T10:00" --end "2026-03-20T11:00" --attendees "team@example.com"
Enter fullscreen mode Exit fullscreen mode

Bugünün ajandasını alın:

gws calendar +agenda --today
Enter fullscreen mode Exit fullscreen mode

E-Tablolar

Satır ekleyin:

gws sheets +append --spreadsheetId <ID> --range "Sheet1!A:C" --values "Görev X,Tamamlandı,2026-03-16"
Enter fullscreen mode Exit fullscreen mode

Dokümanlar

Metin ekleyin:

gws docs +write --documentId <ID> --text "Google Workspace CLI aracılığıyla yeni bölüm eklendi"
Enter fullscreen mode Exit fullscreen mode

Chat

Mesaj gönderin:

gws chat +send --space <SPACE_ID> --text "Dağıtım tamamlandı 🚀"
Enter fullscreen mode Exit fullscreen mode

Her komutta --dry-run ile çağrıyı yürütmeden önizleyin. Tam sayfalandırma için --page-all ile NDJSON çıktısı alın.

Gelişmiş Yapılandırma

Ortam değişkeni veya .env ile ayarları kalıcılaştırın:

export GOOGLE_WORKSPACE_CLI_DEFAULT_PARAMS='{"prettyPrint":true}'
Enter fullscreen mode Exit fullscreen mode

Zaman aşımı, çıktı formatı (--json, --yaml) veya dosya tabanlı anahtarlık ayarlarını düzenleyin. Tüm yapılandırmayı görüntüleyin:

gws config
Enter fullscreen mode Exit fullscreen mode

Yapay Zeka Ajanları ile Entegrasyon

Ajan becerileri yüklendikten sonra, agent’ınız Workspace CLI komutlarını doğal şekilde çağırabilir.

Kullanım Modeli

Örneğin, bir istekte "Son Drive dosyalarımı Google Workspace CLI kullanarak listele" veya "Google Workspace CLI aracılığıyla bir takip e-postası gönder" gibi ifadeler kullanabilirsiniz.

Otomatik Çağırma Kuralı

Ajan talimatlarına ekleyin:

"Görev Gmail, Drive, Takvim, E-Tablolar, Dokümanlar veya Chat'i içeriyorsa, yanıtlamadan önce Google Workspace CLI komutlarını otomatik olarak kullanın. Önce hizmeti ve yöntemi çözün."

Ajanlar, dosya yolları veya JSON sonuçları döndürerek bağlamı sade tutar.

API Doğrulaması için Apidog Entegrasyonu

Google Workspace CLI ile anında veri erişimi sağlayabilirsiniz, fakat API yüklerini ve yanıtları doğrulamak için Apidog ile birlikte kullanmanız önerilir.

Apidog ile yapabilecekleriniz:

  • İstek gönderin, yanıtları inceleyin
  • OAuth token’lar ile ortamlar oluşturun
  • Doğrulamaları otomatikleştirin

Pratik iş akışları:

  • Ajan bir E-Tabloya ekleme önerdiğinde, önce ilgili Sheets API yükünü Apidog’da test edin.
  • Gmail gönderme kapsamlarını, Apidog arayüzünde görsel olarak oluşturup çalıştırın.
  • Hizmet hesabı anahtarları veya kullanıcı jetonlarını değişken olarak saklayıp davranışı doğrulayın.

Google Workspace CLI + Apidog kombinasyonu ile canlı veri erişimi ve tekrarlanabilir API testini bir arada elde edersiniz.

Sıkça Sorulan Sorular

Google Workspace CLI verilerimi dışarı gönderiyor mu?

Hayır. Tüm çağrılar doğrudan Google API’lerine yapılır. İçeriğiniz Google hesabınızdan ayrılmaz.

Hangi hizmetler destekleniyor?

Drive, Gmail, Takvim, E-Tablolar, Dokümanlar, Chat, Yönetici, Komut Dosyası ve tüm dinamik olarak keşfedilen Workspace API’leri.

Komutlar güncel mi?

Evet. CLI, canlı Discovery Service’i sorgular; yeni yöntemler otomatik olarak görünür.

API anahtarı gerekli mi?

Sadece standart Google OAuth veya servis hesabı kimlik bilgileri gerekir, ayrı bir API anahtarı gerekmez.

Hangi ajan ve editörlerle çalışır?

Claude Code, Cursor, OpenClaw, Gemini CLI, VS Code uzantıları ve tüm MCP/Ajan Becerileri uyumlu araçlar.

Ham komutlar ile + yardımcılar farkı nedir?

Ham: Kesin API yöntemleri (ör. drive.files.list).

  • yardımcılar: Sık kullanılan görevler için kısa yol (ör. +upload, +send).

CLI’yı ajansız kullanabilir miyim?

Evet. Komut dosyası, otomasyon veya terminal işleri için idealdir.

Ek Kaynaklar

Top comments (0)