Google Workspace CLI, tüm Workspace API'larını tek bir açık kaynak komutun arkasına topluyor

Tüm Workspace API yüzeyi için tek bir CLI

Google, geliştiricilere Drive, Gmail, Calendar, Sheets, Docs, Chat ve Admin API'ları dahil olmak üzere tüm Google Workspace API yüzeyine tek bir giriş noktası sunan açık kaynak komut satırı aracı gws'yi yayınladı. dev.to'daki bir tanıtım yazısına göre araç, 2026'nın başlarında Google ekibi tarafından yayınlandı ve Addy Osmani tarafından duyuruldu.

Bu motivasyon, daha önce Workspace'e karşı script yazmış herkese tanıdık gelecektir. Bu servisleri otomatikleştirmek normalde servis başına OAuth scope'ları ve kimlik bilgilerini yapılandırmak, her API'nin inceliklerini öğrenmek, sayfalama (pagination) işlemini elle yapmak, birden fazla SDK'yı sürdürmek ve API metotları değiştiğinde scriptleri yeniden yazmak anlamına geliyor. gws, tüm bu işi tek bir arayüzde birleştiriyor; Rust ile yazılan araç, sabit bir komut kataloğu göndermek yerine Workspace API metotlarını runtime'da keşfediyor.

Komutlar Google'ın Discovery Service'inden üretiliyor

CLI, komutlarını Google'ın Discovery Service'inden dinamik olarak oluşturuyor; böylece bir Workspace API'sinin sunduğu her metot shell'den çağrılabilir hale geliyor. dev.to rehberi, bu tasarımla gelen birkaç yeteneği öne çıkarıyor: jq gibi araçlara sorunsuz aktarılabilen JSON çıktısı, çağrıları önizlemek için dry-run desteği ve sayfalama yardımcıları.

Üretilen komutların yanı sıra gws, yaygın görevler için kırktan fazla kolaylık komutuyla geliyor. Rehberdeki örnekler arasında ekli e-posta göndermek (gws gmail +send), bir mesaja yanıt vermek, gelen kutusunu ayıklamak, Drive'a dosya yüklemek, katılımcılarla Calendar etkinliği oluşturmak, günün ajandasını yazdırmak, bir Sheet'e satır eklemek, bir Doc'a metin yerleştirmek ve bir Chat alanına gönderi yapmak yer alıyor.

Sayfalama, tüm sayfaları çekip satır sonu ayrılmış (newline-delimited) JSON üreten bir --page-all flag'i ile ele alınıyor; rehber, bunun büyük sonuç kümelerini akışla işlemeye uygun olduğunu belirtiyor.

Kurulum ve kimlik doğrulama

gws, Node.js 18 veya daha yeni bir sürüm gerektiriyor. Rehber birkaç kurulum yöntemini anlatıyor: npx (@googleworkspace/cli) ile geçici olarak çalıştırmak, npm ile global kurmak ya da GitHub Releases, Homebrew veya Nix üzerinden önceden derlenmiş binary'leri çekmek. npm paketi önceden derlenmiş binary'leri içerdiğinden Rust projesini yerel olarak derlemek gerekmiyor.

Kimlik doğrulama, gws auth setup rehberli komutuyla yürütülüyor; bu komut bir tarayıcı açıyor ve gerekiyorsa bir Google Cloud projesi oluşturmayı, gereken Workspace API'larını etkinleştirmeyi, ilk OAuth akışını tamamlamayı ve kimlik bilgilerini AES-256-GCM ile şifreleyerek işletim sisteminin keyring'inde saklamayı hallediyor. Kurulum varsayılan olarak global uygulanıyor; projeye özel yapılandırma için bir --project flag'i var. Yardımcı komutlar ise giriş, çıkış ile mevcut kullanıcıya ve verilmiş scope'lara bakmayı kapsıyor.

CI ve diğer ekransız ortumlar için kimlik bilgileri bir dosyaya aktarılabilir ve bir ortam değişkeniyle referans verilebilir; tabii dışa aktarılan dosyaya bir secret olarak davranılması gerektiği uyarısıyla. CLI ayrıca gcloud'un yazdırdığı bir access token'ı yeniden kullanabiliyor. Anonim kullanım telemetrisi tek bir ortam değişkeniyle kapatılabiliyor.

AI ajanları göz önünde bulundurularak geliştirildi

dev.to yazısından dikkat çekici bir ayrıntı, gws'nin Claude Code, Cursor, OpenClaw ve Gemini CLI için agent skill'lerle gelmesi. Dry-run flag'i tam burada işe yarıyor: bir ajanın ürettiği komut, gerçek Workspace verisine dokunmadan önce önizlenebiliyor ve operatörler otomasyon CI'da çalışmadan önce istek payload'larını inceleyebiliyor.

JSON öncelikli çıktı da bunu pekiştiriyor. Tüketici bir shell script, bir CI pipeline ya da bir coding agent olsun, araç insan için biçimlendirilmiş metin yerine yapılandırılmış veri döndürüyor; bu da Workspace otomasyonundan kırılgan bir ayrıştırma katmanını kaldırıyor.

Neden önemli

Google Workspace, kurumsal dünyada en çok otomatikleştirilen yazılım paketlerinden biri; ancak genişliği her zaman script yazılabilirliğe karşı çalıştı: her servis kendi API yapısı, SDK'sı ve kimlik doğrulama sürtünmesiyle geliyordu. gws, komutları runtime'da keşfederek, OAuth'ı rehberli bir akışa sararak ve dry-run güvenlik ağlarıyla JSON çıktısında standartlaşarak bu yükün önemli bir kısmını ortadan kaldırıyor.

Ajan entegrasyonları tartışmaya açıksa daha büyük sinyal onlar. Coding agent'lar daha fazla operasyonel iş üstlendikçe, geniş API yüzeylerini tek tip, makine dostu bir komut satırı üzerinden sunan araçlar, bu ajanlarla yönetmeleri istenen yazılım arasındaki bağ dokusu haline geliyor. gws anlatıldığı gibi olgunlaşırsa, geliştiricilerin ve ajanların Workspace ile programatik olarak etkileşiminin varsayılan yolu haline gelebilir; elle yazılmış curl script koleksiyonlarının ve servis başına SDK yapıştırıcılarının yerini alabilir.

Bu hikayenin tek kaynağı bir dev.to tanıtım yazısı; dolayısıyla yayın zamanı ve özellik listesi gibi ayrıntılar bu anlatımı yansıtıyor.