cli
İnsanlar ve AI ajanları için geliştirilmiş, Google Workspace için tek bir CLI.
Sıfır şablon kodu ve yapılandırılmış JSON çıktısıyla Drive, Gmail, Calendar ve Sheets'i sorgulayın.
Bu, tüm Workspace API'leri için dinamik olarak bir komut yüzeyi oluşturmak üzere çalışma zamanında Google'ın Discovery Service'ini okuyan bir komut satırı aracıdır. İş akışlarını betik haline getirmek veya çalışma alanı verilerini AI ajanlarına beslemek isteyen geliştiriciler ve yönetici asistanları için uygundur.
Nedir
Sabit kodlanmış statik komut listelerine ihtiyaç duymadan Google Workspace hizmetleri arasında API çağrıları yürütür. Her yanıt yapılandırılmış JSON çıktısı verir ve otomatik görev yürütme için 40'tan fazla agent skill ile bir Gemini CLI eklentisi içerir.
Kimler için
Komut satırı araçları ve OAuth kurulumu konusunda rahat olan teknik profesyoneller, sistem yöneticileri ve ileri düzey kullanıcılar için uygundur. Grafik arayüzler veya basit sihirbaz tabanlı masaüstü uygulamaları bekleyen teknik olmayan kullanıcılara uygun değildir.
Temel özellikler
Dinamik Komut Yüzeyi
Yeni eklenen API uç noktalarının otomatik olarak algılanması için Google'ın Discovery Service'ini çalışma zamanında okur.
Yapılandırılmış JSON Çıktısı
Kabuk (shell) betikleri ve AI ajanlarıyla doğrudan entegre olmak için her yanıtta temiz JSON döndürür.
Yerleşik AI Agent Skill'leri
LLM'ler tarafından doğrudan çalışma alanı kontrolü için 100'den fazla agent skill ve bir Gemini CLI eklentisi içerir.
Çoklu Kimlik Doğrulama İş Akışları
CI ortamları için etkileşimli kurulumu, manuel OAuth'u, servis hesaplarını ve önceden alınmış erişim belirteçlerini destekler.
3 adımda hazır
Dürüst kararımız
Artıları
- Google REST belgelerine karşı ham curl çağrıları yazma ihtiyacını ortadan kaldırır.
- jq ile kolay boru hattı (pipeline) filtrelemesi için sayfalandırılmış sonuçları NDJSON olarak akışa alır.
- Yıkıcı API eylemleri için kuru çalıştır (dry-run) önizleme yetenekleri sağlar.
- Bir Nix flake ve birden fazla platformda önceden derlenmiş ikili dosyalar (binary) içerir.
Eksileri
- Manuel Google Cloud proje yapılandırması ve OAuth onay ekranı kurulumu gerektirir.
- Test modundaki doğrulanmamış OAuth uygulamaları, gmail.com hesapları için katı kapsam sınırlarına takılır.
- v1.0 öncesinde kırılma değişikliklerinin (breaking changes) beklendiği aktif geliştirme aşamasındadır.
Fiyatlar & lisans
Araç, açık kaynak lisansı altında ücretsiz olarak kullanılabilir. İlişkili tek maliyet, bir Google Cloud projesi yapılandırmak için harcadığınız zaman ve olası Google Cloud API kota kullanımıdır.
Türkçe konuşanlar için işler
880 açık uzaktan yapay zeka eğitimi işi, 15 Kasım 2026 tarihinde güncellendi; çoğu saatlik $20–$175 ödüyor. Bunların 2 tanesi Türkçe konuşanlar için. Zekai ücretsiz listeler; başvuru işverenin platformunda yapılır.
Alternatifler
Kullanın ya da biz kuralım
SSS
gws kimlik doğrulama kurulumu neden gcloud gerektirir?
Google Cloud projenizin oluşturulmasını otomatikleştirmek ve gerekli API'leri etkinleştirmek için gcloud CLI'yı kullanır.
Test modunda OAuth kapsamı sınırlarını nasıl yönetirim?
Önerilen 85'ten fazla kapsamın tümünü aynı anda istemek yerine, -s drive,gmail,sheets gibi bayrakları kullanarak ayrı hizmetler seçmelisiniz.
Bunu başsız (headless) CI ortamlarında kullanabilirim?
Evet, yetkilendirilmiş bir makineden kimlik bilgilerini dışarı aktarıp GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE çevre değişkenini ayarlayarak kullanabilirsiniz.
